CKTIS / PHP
Parameter odovzdávaný odkazom (`&$list`)
Znak `&` pred `$list` umožňuje funkcii v PHP zmeniť premennú volajúceho. Píše sa do deklarácie parametra, nie pred argument pri volaní funkcie.
Verzia: PHP 8.3
Syntax
<?php
function appendItem(array &$list, string $item): void
{
$list[] = $item;
}
$items = ['apple'];
appendItem($items, 'pear');V PHP 8.3 označuje &$list parameter odovzdávaný odkazom. Pri volaní appendItem($items, 'pear') sa lokálny názov $list stane aliasom toho istého obsahu, ku ktorému pristupuje $items. Odkaz v PHP nie je ukazovateľ na adresu v pamäti. $list je bežný názov parametra a nesúvisí s konštrukciou list() na rozklad poľa.
Syntax odkazov, operácie s poľami ani funkcia implode() použité v príklade nevyžadujú žiadne voliteľné rozšírenie PHP.
Znak & napíš pred názov parametra v deklarácii, nie pred argument pri volaní. Odovzdaj premennú, napríklad $items; odovzdanie literálu ako ['apple'] tomuto parametru je chyba. Odovzdať možno aj výsledok vrátený odkazom. Prijatie argumentu odkazom neznamená vrátenie výsledku odkazom.
$list[] = $item pridá prvok do poľa volajúceho a $list = [] by nahradilo celé pole. Zmeny zostanú viditeľné aj po návrate z funkcie. Naopak unset($list) vo funkcii zruší len lokálne prepojenie, nie premennú $items. Bez & sa argument predvolene odovzdáva hodnotou, takže pridanie prvku v príklade by $items nezmenilo.
Pri array &$list PHP kontroluje typ array pri vstupe do funkcie, nie pri návrate. Odovzdanie premennej obsahujúcej celé číslo vyvolá TypeError. void sa týka návratovej hodnoty, nie zmeny argumentu. Odkaz použi, ak chceš premennú volajúceho zámerne zmeniť, a zdokumentuj tento vedľajší účinok, pretože zo samotného volania nie je zrejmý.
Príklady
<?php
function appendItem(array &$list, string $item): void
{
$list[] = $item;
}
$items = ['apple'];
appendItem($items, 'pear');
echo implode(', ', $items), "\n";
Výsledok
apple, pear
Po volaní `appendItem()` skript vypíše `$items`, nie návratovú hodnotu funkcie. Očakávaný riadok je `apple, pear`. Na porovnanie odstráň z deklarácie parametra iba `&`: očakávaný riadok potom bude `apple`.
Súvisiace lekcie
- PHP · Lekcia 20 · Stredne pokročilá · Verzia: 3