WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

Referenzparameter `&$value` und Wertübergabe

In PHP 8.3 kann eine Funktion über den Parameter `&$value` die Variable des Aufrufers ändern. Bei der standardmäßigen Wertübergabe ändert eine Zuweisung an den Parameter diese Variable nicht.

Version: PHP 8.3; extension availability may vary

Syntax

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

In der Deklaration int &$value kennzeichnet & die Übergabe per Referenz. Der lokale Parameter $value und die Variable des Aufrufers sind zwei Namen für denselben Wert; eine PHP-Referenz ist kein Zeiger wie in C. Eine Zuweisung an $value ändert den Wert beim Aufrufer, und die Rückkehr aus der Funktion macht die Änderung nicht rückgängig.

Schreibe & in die Deklaration, nicht in den Aufruf: addOneByReference($number). Übergib eine Variable oder das Ergebnis einer Funktion, die ausdrücklich per Referenz zurückgibt. Ein Literal wie 5 verursacht einen Fehler; gewöhnliche Ausdrücke wie $number + 1 sind hier keine gültigen Argumente. Ein & vor dem Funktionsnamen kennzeichnet die Rückgabe per Referenz, keinen Referenzparameter.

Ohne & gilt die Wertübergabe: Eine Zuweisung an $value bleibt lokal. Ist das Argument ein Objekt, können beide Variablen dennoch dasselbe Objekt bezeichnen. Änderungen an seinen Eigenschaften können daher beim Aufrufer sichtbar sein; die Zuweisung eines anderen Objekts an den Parameter ändert die Variable des Aufrufers dagegen nicht.

Bei int &$value wird der Parametertyp beim Eintritt in die Funktion geprüft, nicht bei der Rückkehr. Die Deklaration allein garantiert daher nicht, dass eine gewöhnliche Variable des Aufrufers danach noch vom Typ int ist. Verwende &, wenn die Änderung dieser Variable zum vereinbarten Verhalten der Funktion gehört, und dokumentiere den Seiteneffekt. Andernfalls kannst du den neuen Wert zurückgeben.

Beispiele

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

Ergebnis

by value: 5
by reference: 6

Beide Funktionen führen `$value += 1` aus. Nach der Wertübergabe bleibt `$number` bei `5`; nach der Referenzübergabe ist der Wert `6`.

Zugehörige Lektionen

  • PHP · Lektion 77 · Fortgeschritten · Version: 2

Quellen