CKTIS / PHP
Zwracanie przez referencję: `function &getSession`
Funkcja zwracająca przez referencję pozwala wywołującemu utworzyć alias zmiennej. Zapis `=&` wiąże alias, a zwykłe `=` pobiera wartość bez tworzenia tego powiązania.
Wersja: PHP 8.3; extension availability may vary
Składnia
function &getSession(): array { static $state = []; return $state; }
$alias = &getSession(); // Bind an alias to the returned variable.
$copy = getSession(); // Assign the array by value.W PHP 8.3 znak & przed nazwą w deklaracji function &getSession(): array oznacza zwracanie przez referencję. Typ array określa typ zwracanej wartości. Zapis return $state; wskazuje zmienną; nie dodawaj & po return. Literał ani wynik obliczenia nie są zmiennymi i nie można ich poprawnie zwrócić przez referencję.
Zapis $alias = &getSession(); wiąże drugą nazwę z tą samą zmienną. Zmiana $alias['visits'] zmienia przechowywaną tablicę. Natomiast $copy = getSession(); przypisuje tablicę przez wartość, więc zmiana $copy['visits'] nie zmienia oryginału. To nie jest przekazywanie argumentu przez referencję: & w deklaracji dotyczy wyniku, a =& wiąże alias po stronie wywołującego.
getSession() to funkcja zdefiniowana w przykładzie, a nie wbudowane API sesji. Lokalna zmienna static zachowuje wartość między wywołaniami w tym samym uruchomieniu, ale nie przechowuje danych między żądaniami. Przykład nie wymaga rozszerzenia sesji. Aby ręcznie uruchomić lub wznowić sesję PHP, potrzebujesz obsługi sesji i udanego wywołania session_start(); dane sesji znajdują się w $_SESSION.
Zwracaj referencję tylko wtedy, gdy wywołujący ma mieć możliwość bezpośredniej zmiany stanu, a nie w celu przyspieszenia kodu. Jeśli zmiany wymagają walidacji, udostępnij osobną funkcję aktualizującą zamiast zapisywalnego aliasu.
Przykłady
<?php
function &getSession(): array
{
static $state = ['visits' => 1];
return $state;
}
$copy = getSession();
$alias = &getSession();
$alias['visits']++;
$copy['visits'] += 10;
$current = getSession();
echo 'Stored: ', $current['visits'], "\n";
echo 'Copy: ', $copy['visits'], "\n";
Wynik
Stored: 2 Copy: 11
Zmiana przez alias zwiększa przechowywane `visits` do `2`. Kopia została pobrana wcześniej, więc dodanie do niej `10` daje `11` bez zmiany oryginału.
Powiązane lekcje
- PHP · Lekcja 25 · Średniozaawansowany · Wersja: 3