KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

Retourneren via een referentie: `function &getSession`

Een functie die via een referentie retourneert, laat de aanroeper een alias voor een variabele maken. `=&` legt die koppeling; `=` wijst alleen de waarde toe.

Versie: PHP 8.3; extension availability may vary

Syntax

function &getSession(): array { static $state = []; return $state; }
$alias = &getSession(); // Bind an alias to the returned variable.
$copy = getSession();   // Assign the array by value.

In PHP 8.3 geeft de & vóór de naam in function &getSession(): array aan dat de functie via een referentie retourneert. array geeft het retourtype aan. Gebruik return $state; om de variabele aan te duiden, zonder & achter return. Een letterlijke waarde of het resultaat van een berekening is geen variabele en kan niet geldig via een referentie worden geretourneerd.

$alias = &getSession(); koppelt een tweede naam aan dezelfde variabele. Een wijziging aan $alias['visits'] verandert de opgeslagen array. Daarentegen wijst $copy = getSession(); de array op waarde toe, zodat een wijziging aan $copy['visits'] het origineel niet verandert. Dit is geen argument doorgeven via een referentie: de & in de declaratie betreft het resultaat en =& legt de koppeling bij de aanroeper.

getSession() is in het voorbeeld gedefinieerd en is geen ingebouwde sessie-API. De lokale static-variabele behoudt haar waarde tussen aanroepen binnen dezelfde uitvoering, maar bewaart geen gegevens tussen verzoeken. Het voorbeeld heeft geen sessie-extensie nodig. Om handmatig een echte PHP-sessie te starten of te hervatten, moet sessieondersteuning beschikbaar zijn en moet session_start() slagen; de sessiegegevens staan in $_SESSION.

Retourneer alleen een referentie als de aanroeper de onderliggende toestand rechtstreeks mag wijzigen, niet om de code sneller te maken. Moeten wijzigingen worden gevalideerd, bied dan een aparte updatefunctie aan in plaats van een beschrijfbare alias.

Voorbeelden

<?php
function &getSession(): array
{
    static $state = ['visits' => 1];
    return $state;
}

$copy = getSession();
$alias = &getSession();

$alias['visits']++;
$copy['visits'] += 10;

$current = getSession();
echo 'Stored: ', $current['visits'], "\n";
echo 'Copy: ', $copy['visits'], "\n";

Resultaat

Stored: 2
Copy: 11

De wijziging via de alias verhoogt de opgeslagen `visits` naar `2`. De kopie is eerder gemaakt, dus `10` erbij optellen geeft `11` zonder het origineel te veranderen.

Gerelateerde lessen

  • PHP · Les 25 · Gemiddeld · Versie: 3

Bronnen