CKTIS / PHP
Parameter die per referentie wordt doorgegeven (`&$list`)
Met `&` vóór `$list` kan een PHP-functie de variabele van de aanroeper wijzigen. Het teken staat in de parameterdeclaratie, niet vóór het argument bij de aanroep.
Versie: PHP 8.3
Syntax
<?php
function appendItem(array &$list, string $item): void
{
$list[] = $item;
}
$items = ['apple'];
appendItem($items, 'pear');In PHP 8.3 declareert &$list een parameter die per referentie wordt doorgegeven. Bij appendItem($items, 'pear') wordt de lokale naam $list een alias voor dezelfde inhoud als $items. Een PHP-referentie is geen pointer naar een geheugenadres. $list is een gewone parameternaam en heeft niets te maken met de taalconstructie list() voor destructurering.
De referentiesyntaxis, de arraybewerkingen en de functie implode() in het voorbeeld vereisen geen optionele PHP-extensies.
Zet & vóór de parameternaam in de declaratie, niet vóór het argument bij de aanroep. Geef een variabele door, bijvoorbeeld $items; een letterlijke waarde zoals ['apple'] doorgeven aan die parameter is een fout. Een resultaat dat per referentie wordt teruggegeven is ook geldig. Een argument per referentie ontvangen betekent niet dat de functie per referentie retourneert.
$list[] = $item voegt een element toe aan de array van de aanroeper; $list = [] zou de hele array vervangen. Die wijzigingen blijven na de aanroep zichtbaar. Daarentegen verbreekt unset($list) binnen de functie alleen de lokale koppeling en verwijdert het $items niet. Zonder & wordt het argument standaard per waarde doorgegeven, zodat de getoonde toevoeging $items niet zou wijzigen.
Bij array &$list controleert PHP het type array bij het binnengaan van de functie, niet bij terugkeer. Een variabele met een geheel getal doorgeven veroorzaakt een TypeError. void gaat over de retourwaarde, niet over de wijziging van het argument. Gebruik een referentie als je bewust de variabele van de aanroeper wilt wijzigen en documenteer dat neveneffect, want het is niet zichtbaar in de aanroep.
Voorbeelden
<?php
function appendItem(array &$list, string $item): void
{
$list[] = $item;
}
$items = ['apple'];
appendItem($items, 'pear');
echo implode(', ', $items), "\n";
Resultaat
apple, pear
Na de aanroep van `appendItem()` toont het script `$items`, niet de retourwaarde van de functie. De verwachte regel is `apple, pear`. Verwijder ter vergelijking alleen `&` uit de parameterdeclaratie: de verwachte regel is dan `apple`.
Gerelateerde lessen
- PHP · Les 20 · Gemiddeld · Versie: 3