KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / PHP

Parameter die per referentie wordt doorgegeven: &$session

Met `&` vóór `$session` kan de functie de array van de aanroeper rechtstreeks wijzigen. De parameter start geen PHP-sessie en slaat geen sessiegegevens op.

Versie: PHP 8.3; extension availability may vary

Syntax

function recordVisit(array &$session): void { /* update $session */ }
recordVisit($state);

In PHP 8.3 verwijzen bij array &$session de lokale naam $session en de meegegeven variabele naar dezelfde waarde. Een wijziging aan een array-element of vervanging van de hele array werkt door bij de aanroeper, ook al heeft de functie retourtype void. Zonder & wordt een gewone array standaard op waarde doorgegeven; zulke wijzigingen blijven dan lokaal.

Zet & in de parameterdeclaratie, niet in de aanroep: recordVisit($state). Geef een variabele door, geen letterlijke array zoals []. PHP controleert het type array bij het begin van de aanroep, niet bij terugkeer; een argument van het verkeerde type veroorzaakt een TypeError.

$session is alleen een parameternaam, niet de superglobale variabele $_SESSION. Als de sessie-extensie beschikbaar is, kun je na een geslaagde session_start() de functie aanroepen met recordVisit($_SESSION). Het sessiemechanisme van PHP slaat de gegevens op, niet &; reken er niet op dat verwijzingen tussen verzoeken worden hersteld. Het consolevoorbeeld heeft de extensie niet nodig.

Voorbeelden

<?php

function recordVisit(array &$session): void
{
    $session['visits'] = ($session['visits'] ?? 0) + 1;
}

$state = [];
recordVisit($state);
echo $state['visits'], "\n";
recordVisit($state);
echo $state['visits'], "\n";

Resultaat

1
2

De gewone array `$state` is eerst leeg. De teller is `1` na de eerste aanroep en `2` na de tweede; er wordt geen PHP-sessie gestart.

Gerelateerde lessen

  • PHP · Les 25 · Gemiddeld · Versie: 3

Bronnen