CKTIS / PHP
Parametr przekazywany przez referencję (`&$projects`)
Zapis `&$projects` pozwala funkcji zmienić zmienną przekazaną przez wywołującego. Znak `&` umieszcza się w deklaracji parametru, nie w wywołaniu.
Wersja: PHP 8.3; extension availability may vary
Składnia
function addProject(array &$projects, string $name): void { $projects[] = $name; }
addProject($activeProjects, 'Beacon');W PHP 8.3 zapis array &$projects deklaruje parametr przekazywany przez referencję. Podczas wywołania $projects w funkcji i $activeProjects u wywołującego są dwiema nazwami tej samej zawartości. Zarówno dopisanie elementu przez $projects[] = $name, jak i przypisanie całej nowej tablicy do $projects zmienia zmienną wywołującego. Zmiana jest widoczna po powrocie z funkcji; void oznacza, że funkcja nie zwraca wyniku.
Znak & umieszcza się tylko w deklaracji parametru. Wywołaj addProject($activeProjects, 'Beacon') bez &. Przekaż zainicjalizowaną zmienną zamiast literału tablicowego, takiego jak [], którego przekazanie w tym miejscu jest błędem. Wynik funkcji zwracającej przez referencję też może być argumentem; zwykły wynik zwrócony przez wartość nie zastępuje zmiennej.
PHP sprawdza typ array przy wejściu do funkcji, a nie przy wyjściu. Jeśli zainicjalizowana zmienna zawiera wartość, która nie jest tablicą, wywołanie zgłosi TypeError. Sama deklaracja parametru nie gwarantuje jednak, że funkcja pozostawi w zmiennej tablicę.
Bez & argument jest domyślnie przekazywany przez wartość: dopisanie elementu w tym przykładzie zmieniłoby tylko lokalną tablicę. Używaj referencji, gdy zmiana zmiennej wywołującego jest zamierzona, i udokumentuj ten efekt. Jeśli zmienna ma pozostać bez zmian, przekaż tablicę przez wartość i zwróć zmienioną wersję.
Przykłady
<?php
function addProject(array &$projects, string $name): void
{
$projects[] = $name;
}
$activeProjects = ['Atlas'];
echo implode(', ', $activeProjects), "\n";
addProject($activeProjects, 'Beacon');
echo implode(', ', $activeProjects), "\n";
Wynik
Atlas Atlas, Beacon
Pierwszy wiersz pokazuje stan przed wywołaniem. Drugi pokazuje, że do zmiennej `$activeProjects` dopisano `Beacon`, mimo że `addProject()` nie zwraca wyniku.
Powiązane lekcje
- PHP · Lekcja 12 · Średniozaawansowany · Wersja: 3
- PHP · Lekcja 13 · Średniozaawansowany · Wersja: 3