База знанияИзпитен център
BGБългарски
Избери език13

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

Източници