CKTIS / PHP
Параметър, предаван по референция (`&$projects`)
С `&$projects` функцията може да промени променливата на извикващия код. Знакът `&` се пише в декларацията на параметъра, а не при извикването.
Версия: PHP 8.3; extension availability may vary
Синтаксис
function addProject(array &$projects, string $name): void { $projects[] = $name; }
addProject($activeProjects, 'Beacon');В PHP 8.3 array &$projects декларира параметър, предаван по референция. По време на извикването $projects във функцията и $activeProjects в извикващия код са две имена за едно и също съдържание. Както добавянето на елемент чрез $projects[] = $name, така и присвояването на изцяло нов масив на $projects променя променливата на извикващия код. Промяната остава видима и след края на извикването; void означава, че функцията не връща резултат.
Постави & само в декларацията на параметъра. Извикай addProject($activeProjects, 'Beacon') без &. Предай инициализирана променлива вместо литерал за масив като [], който на това място води до грешка. Можеш да предадеш и референция, върната от функция; обикновена върната стойност не замества променлива.
PHP проверява типа array при влизане във функцията, а не при излизане. Ако инициализираната променлива не съдържа масив, извикването предизвиква TypeError. Самата декларация на параметъра обаче не гарантира, че функцията ще остави масив в променливата.
Без & аргументът по подразбиране се предава по стойност: в този пример добавянето би променило само локалния масив. Използвай референция, когато умишлено променяш променливата на извикващия код, и документирай този ефект. Ако тя трябва да остане непроменена, предай масива по стойност и върни обновен масив.
Примери
<?php
function addProject(array &$projects, string $name): void
{
$projects[] = $name;
}
$activeProjects = ['Atlas'];
echo implode(', ', $activeProjects), "\n";
addProject($activeProjects, 'Beacon');
echo implode(', ', $activeProjects), "\n";
Резултат
Atlas Atlas, Beacon
Първият ред показва състоянието преди извикването. Вторият показва, че `Beacon` е добавен към `$activeProjects`, въпреки че `addProject()` не връща резултат.
Свързани уроци
- PHP · Урок 12 · Средно · Версия: 3
- PHP · Урок 13 · Средно · Версия: 3