Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła