CKTIS / PHP
Parameter, podan po referenci (`&$list`)
Znak `&` pred `$list` omogoča, da funkcija PHP spremeni spremenljivko klicatelja. Zapišemo ga v deklaraciji parametra, ne pred argumentom pri klicu.
Različica: PHP 8.3
Sintaksa
<?php
function appendItem(array &$list, string $item): void
{
$list[] = $item;
}
$items = ['apple'];
appendItem($items, 'pear');V PHP 8.3 zapis &$list označuje parameter, podan po referenci. Pri klicu appendItem($items, 'pear') lokalno ime $list postane drugo ime za isto vsebino kot $items. Referenca v PHP ni kazalec na pomnilniški naslov. $list je običajno ime parametra in ni povezano z jezikovnim konstruktom list() za razčlenjevanje polj.
Sintaksa referenc, operacije s polji in funkcija implode() v primeru ne zahtevajo izbirnih razširitev PHP.
Znak & zapiši pred imenom parametra v deklaraciji, ne pred argumentom pri klicu. Podaj spremenljivko, na primer $items; če parametru podaš literal, kot je ['apple'], nastane napaka. Podaš lahko tudi rezultat, ki ga funkcija vrne po referenci. Sprejem argumenta po referenci ne pomeni vračanja po referenci.
$list[] = $item doda element v polje klicatelja, $list = [] pa bi zamenjal celotno polje. Spremembe ostanejo vidne po klicu. Nasprotno unset($list) znotraj funkcije odstrani le lokalno povezavo, ne pa spremenljivke $items. Brez & se argument privzeto poda po vrednosti, zato dodajanje iz primera ne bi spremenilo $items.
Pri array &$list PHP preveri tip array ob vstopu v funkcijo, ne ob vrnitvi. Če podana spremenljivka vsebuje celo število, nastane TypeError. void opisuje vrnjeno vrednost, ne spremembe argumenta. Referenco uporabi, kadar želiš spremeniti spremenljivko klicatelja, in dokumentiraj ta stranski učinek, saj iz klica ni razviden.
Primeri
<?php
function appendItem(array &$list, string $item): void
{
$list[] = $item;
}
$items = ['apple'];
appendItem($items, 'pear');
echo implode(', ', $items), "\n";
Rezultat
apple, pear
Po klicu `appendItem()` skript izpiše `$items`, ne vrednosti, ki bi jo vrnila funkcija. Pričakovana vrstica je `apple, pear`. Za primerjavo iz deklaracije parametra odstrani samo `&`: pričakovana vrstica je nato `apple`.
Povezane lekcije
- PHP · Lekcija 20 · Srednja · Različica: 3