WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

Referenzparameter: &$session

Mit `&` vor `$session` kann die Funktion das übergebene Array direkt ändern. Der Parameter startet keine PHP-Sitzung und speichert auch keine Sitzungsdaten.

Version: PHP 8.3; extension availability may vary

Syntax

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

In PHP 8.3 beziehen sich bei array &$session der lokale Name $session und die übergebene Variable auf denselben Wert. Eine Änderung an einem Array-Eintrag oder der Austausch des gesamten Arrays wirkt sich auf die Variable beim Aufrufer aus, obwohl die Funktion void als Rückgabetyp hat. Ohne & wird ein gewöhnliches Array standardmäßig als Wert übergeben; solche Änderungen bleiben dann lokal.

Das & steht in der Parameterdeklaration, nicht im Aufruf: recordVisit($state). Übergib eine Variable, kein Array-Literal wie []. PHP prüft den Typ array beim Eintritt in die Funktion, nicht bei der Rückkehr. Ein Argument mit falschem Typ löst einen TypeError aus.

$session ist nur ein Parametername, nicht die Superglobale $_SESSION. Ist die Sitzungserweiterung verfügbar, kannst du nach einem erfolgreichen session_start() die Funktion mit recordVisit($_SESSION) aufrufen. Die Sitzungsverwaltung von PHP speichert die Daten, nicht &. Verlass dich nicht darauf, dass Referenzen über mehrere Anfragen hinweg wiederhergestellt werden. Das Konsolenbeispiel benötigt die Erweiterung nicht.

Beispiele

<?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";

Ergebnis

1
2

Das gewöhnliche Array `$state` ist anfangs leer. Sein Zähler steht nach dem ersten Aufruf auf `1` und nach dem zweiten auf `2`; es wird keine PHP-Sitzung gestartet.

Zugehörige Lektionen

  • PHP · Lektion 25 · Mittlere Stufe · Version: 3

Quellen