CKTIS / PHP
Parametr referencyjny `&$value` a przekazywanie przez wartość
W PHP 8.3 parametr `&$value` pozwala funkcji zmienić zmienną wywołującego. Domyślnie argument jest przekazywany przez wartość, więc przypisanie do parametru nie zmienia tej zmiennej.
Wersja: PHP 8.3; extension availability may vary
Składnia
function addOneByReference(int &$value): void { $value += 1; }
$number = 5;
addOneByReference($number);W deklaracji int &$value znak & oznacza przekazanie argumentu przez referencję. Lokalny parametr $value i zmienna wywołującego stają się aliasami tej samej wartości; referencja PHP nie jest wskaźnikiem w stylu C. Przypisanie przez $value zmienia wartość widoczną u wywołującego, a powrót z funkcji nie cofa zmiany.
Znak & zapisujesz w deklaracji, nie w wywołaniu: addOneByReference($number). Przekaż zmienną albo wynik funkcji, która jawnie zwraca przez referencję. Literał 5 powoduje błąd; zwykłe wyrażenia, takie jak $number + 1, nie są prawidłowymi argumentami w tym miejscu. Znak & przed nazwą funkcji oznacza zwracanie przez referencję, a nie przekazywanie parametru przez referencję.
Bez & argument jest domyślnie przekazywany przez wartość: przypisanie do $value pozostaje lokalne. Jeśli argumentem jest obiekt, obie zmienne nadal mogą wskazywać ten sam obiekt. Zmiana jego właściwości może więc być widoczna u wywołującego, ale przypisanie innego obiektu do parametru nie zmieni zmiennej wywołującego.
W int &$value typ parametru jest sprawdzany przy wejściu do funkcji, nie przy wyjściu. Sama deklaracja nie gwarantuje więc, że zwykła zmienna wywołującego pozostanie typu int. Używaj &, gdy modyfikacja zmiennej ma być częścią kontraktu funkcji, i opisz ten efekt w dokumentacji. W przeciwnym razie rozważ zwrócenie nowej wartości.
Przykłady
<?php
declare(strict_types=1);
function addOneByValue(int $value): void
{
$value += 1;
}
function addOneByReference(int &$value): void
{
$value += 1;
}
$number = 5;
addOneByValue($number);
echo "by value: $number\n";
addOneByReference($number);
echo "by reference: $number\n";
Wynik
by value: 5 by reference: 6
Obie funkcje wykonują `$value += 1`. Po wywołaniu przez wartość `$number` nadal wynosi `5`; po wywołaniu przez referencję wynosi `6`.
Powiązane lekcje
- PHP · Lekcja 77 · Zaawansowany · Wersja: 2