CKTIS / PHP
Parametr przekazywany przez referencję: &$session
Znak `&` przed parametrem `$session` pozwala funkcji zmienić tablicę przekazaną przez wywołującego. Sam parametr nie uruchamia sesji PHP ani nie zapisuje jej danych.
Wersja: PHP 8.3; extension availability may vary
Składnia
function recordVisit(array &$session): void { /* update $session */ }
recordVisit($state);W PHP 8.3 zapis array &$session oznacza, że lokalna nazwa $session i zmienna przekazana przez wywołującego odnoszą się do tej samej wartości. Zmiana klucza lub przypisanie całej tablicy jest widoczne po powrocie z funkcji, mimo że funkcja ma typ zwracany void. Bez & zwykłą tablicę przekazuje się domyślnie przez wartość, więc taka zmiana pozostaje lokalna.
Znak & umieszcza się w deklaracji parametru, a nie w wywołaniu: recordVisit($state). Przekaż zmienną, nie literał taki jak []. Deklaracja array sprawdza typ na wejściu, a nie przy wyjściu z funkcji; argument o innym typie powoduje błąd TypeError.
$session to zwykła nazwa parametru, nie superglobalna zmienna $_SESSION. Jeśli rozszerzenie sesji jest dostępne, po pomyślnym session_start() można wywołać recordVisit($_SESSION). Za zapis odpowiada mechanizm sesji PHP, a nie &; nie polegaj na odtwarzaniu powiązań referencyjnych między żądaniami. Przykład konsolowy nie wymaga tego rozszerzenia.
Przykłady
<?php
function recordVisit(array &$session): void
{
$session['visits'] = ($session['visits'] ?? 0) + 1;
}
$state = [];
recordVisit($state);
echo $state['visits'], "\n";
recordVisit($state);
echo $state['visits'], "\n";
Wynik
1 2
Zwykła tablica `$state` jest początkowo pusta. Po kolejnych wywołaniach jej licznik ma wartości `1` i `2`; nie uruchamia się żadna sesja PHP.
Powiązane lekcje
- PHP · Lekcja 25 · Średniozaawansowany · Wersja: 3