CKTIS / PHP
Параметър, предаван по референция (`&$list`)
Знакът `&` пред `$list` позволява на PHP функция да променя променливата от извикващия код. Той се пише в декларацията на параметъра, а не пред аргумента при извикването.
Версия: PHP 8.3
Синтаксис
<?php
function appendItem(array &$list, string $item): void
{
$list[] = $item;
}
$items = ['apple'];
appendItem($items, 'pear');В PHP 8.3 записът &$list означава параметър, предаван по референция. При извикване на appendItem($items, 'pear') локалното име $list става друго име за същото съдържание, достъпно чрез $items. Референцията в PHP не е указател към адрес в паметта. $list е обикновено име на параметър и няма връзка с конструкцията list() за разопаковане на масиви.
Синтаксисът за референции, операциите с масиви и функцията implode() в примера не изискват допълнителни разширения на PHP.
Пиши & пред името на параметъра в декларацията, а не пред аргумента при извикването. Подай променлива като $items; подаването на литерал като ['apple'] на този параметър е грешка. Може да се подаде и резултат, върнат по референция. Приемането на аргумент по референция не означава връщане на резултат по референция.
$list[] = $item добавя елемент към масива на извикващия код, а $list = [] би заменило целия масив. Промените остават видими след извикването. За разлика от това unset($list) във функцията премахва само локалната връзка, не и $items. Без & аргументът по подразбиране се предава по стойност и показаното добавяне не би променило $items.
При array &$list PHP проверява типа array при влизане във функцията, а не при излизане. Подаването на променлива, която съдържа цяло число, предизвиква TypeError. void описва върнатата стойност, а не промяната на аргумента. Използвай референция, когато искаш да промениш променливата от извикващия код, и документирай този страничен ефект, защото той не личи от самото извикване.
Примери
<?php
function appendItem(array &$list, string $item): void
{
$list[] = $item;
}
$items = ['apple'];
appendItem($items, 'pear');
echo implode(', ', $items), "\n";
Резултат
apple, pear
След извикването на `appendItem()` скриптът извежда `$items`, а не стойност, върната от функцията. Очакваният ред е `apple, pear`. За сравнение премахни само `&` от декларацията на параметъра: тогава очакваният ред е `apple`.
Свързани уроци
- PHP · Урок 20 · Средно · Версия: 3