Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła