KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

Referentieparameter `&$value` en doorgeven op waarde

In PHP 8.3 kan een functie met de parameter `&$value` de variabele van de aanroeper wijzigen. Bij de standaarddoorgifte op waarde verandert een toewijzing aan de parameter die variabele niet.

Versie: PHP 8.3; extension availability may vary

Syntax

function addOneByReference(int &$value): void { $value += 1; }
$number = 5;
addOneByReference($number);

In de declaratie int &$value geeft & aan dat het argument op referentie wordt doorgegeven. De lokale parameter $value en de variabele van de aanroeper zijn twee namen voor dezelfde waarde; een PHP-referentie is geen pointer zoals in C. Een toewijzing aan $value wijzigt de waarde bij de aanroeper. Die wijziging blijft staan als de functie terugkeert.

Schrijf & in de declaratie, niet in de aanroep: addOneByReference($number). Geef een variabele door of het resultaat van een functie die expliciet op referentie retourneert. Een letterlijke waarde zoals 5 veroorzaakt een fout; gewone expressies zoals $number + 1 zijn hier geen geldige argumenten. Een & vóór de functienaam geeft aan dat de functie op referentie retourneert, niet dat ze een referentieparameter heeft.

Zonder & wordt het argument op waarde doorgegeven: een toewijzing aan $value blijft lokaal. Is het argument een object, dan kunnen beide variabelen nog steeds hetzelfde object aanduiden. Een wijziging aan de eigenschappen van dat object kan dus zichtbaar zijn voor de aanroeper, maar een ander object aan de parameter toewijzen verandert de variabele van de aanroeper niet.

Bij int &$value wordt het parametertype gecontroleerd aan het begin van de aanroep, niet bij terugkeer. De declaratie alleen garandeert dus niet dat een gewone variabele van de aanroeper na afloop nog van het type int is. Gebruik & als het wijzigen van die variabele deel uitmaakt van het functiecontract en documenteer dit neveneffect. Overweeg anders de nieuwe waarde te retourneren.

Voorbeelden

<?php
declare(strict_types=1);

function addOneByValue(int $value): void
{
    $value += 1;
}

function addOneByReference(int &$value): void
{
    $value += 1;
}

$number = 5;
addOneByValue($number);
echo "by value: $number\n";

addOneByReference($number);
echo "by reference: $number\n";

Resultaat

by value: 5
by reference: 6

Beide functies voeren `$value += 1` uit. Na de aanroep op waarde is `$number` nog `5`; na de aanroep op referentie is het `6`.

Gerelateerde lessen

  • PHP · Les 77 · Gevorderd · Versie: 2

Bronnen