CKTIS / PHP
Параметър по референция `&$value` и предаване по стойност
В PHP 8.3 параметърът `&$value` позволява на функцията да промени променлива на извикващия код. При стандартното предаване по стойност присвояването на параметъра не променя тази променлива.
Версия: PHP 8.3; extension availability may vary
Синтаксис
function addOneByReference(int &$value): void { $value += 1; }
$number = 5;
addOneByReference($number);В декларацията int &$value знакът & означава предаване по референция. Локалният параметър $value и променливата на извикващия код са две имена за една и съща стойност; референцията в PHP не е указател като в C. Присвояването на $value променя стойността в извикващия код, а излизането от функцията не отменя промяната.
Поставяй & в декларацията, а не в извикването: addOneByReference($number). Предай променлива или резултата от функция, която изрично връща по референция. Литерал като 5 причинява грешка; обикновени изрази като $number + 1 не са валидни аргументи тук. Знакът & пред името на функцията означава връщане по референция, а не параметър по референция.
Без & аргументът се предава по стойност: присвояването на $value остава локално. Ако аргументът е обект, двете променливи все пак могат да обозначават един и същ обект. Промяната на неговите свойства може да се вижда в извикващия код, но присвояването на друг обект на параметъра не променя променливата там.
При int &$value типът на параметъра се проверява при влизане във функцията, а не при излизане. Самата декларация не гарантира, че обикновена променлива на извикващия код ще остане от тип int след извикването. Използвай &, когато промяната на тази променлива е част от договора на функцията, и документирай този страничен ефект. В противен случай обмисли връщане на новата стойност.
Примери
<?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";
Резултат
by value: 5 by reference: 6
И двете функции изпълняват `$value += 1`. След извикването с предаване по стойност `$number` остава `5`; след извикването с предаване по референция стойността е `6`.
Свързани уроци
- PHP · Урок 77 · Напреднало · Версия: 2