CKTIS / PHP
Referenzparameter (`&$response`)
Mit `&$response` kann eine PHP-Funktion die übergebene Variable des Aufrufers ändern. Das `&` steht in der Parameterdeklaration, nicht beim Aufruf.
Version: PHP 8.3; extension availability may vary
Syntax
function setResponse(string &$response): void { /* Assign to $response here. */ }
setResponse($message);In PHP 8.3 kennzeichnet & vor $response die Übergabe als Referenz. Beim Aufruf setResponse($message) bezeichnen $response und $message denselben gespeicherten Wert. Eine Zuweisung an $response bleibt deshalb nach dem Funktionsende in $message sichtbar. Bei der standardmäßigen Wertübergabe würde diese Zuweisung $message nicht ändern.
Schreibe & nur in die Parameterdeklaration, nicht vor das Argument. Übergib eine Variable wie $message. setResponse('pending') führt zu einem Fehler, weil ein Literal keine Variable ist. Das Ergebnis einer Funktion, die eine Referenz zurückgibt, ist ebenfalls zulässig. Ein gewöhnliches Funktionsergebnis solltest du dagegen nicht so übergeben.
$response ist ein gewöhnlicher Parametername ohne Bezug zu HTTP. : void bedeutet, dass die Funktion keinen Wert zurückgibt. Die Änderung von $message ist ein Seiteneffekt des Aufrufs. Wenn die Funktion nur einen neuen Wert liefern soll, kannst du ihn stattdessen zurückgeben und beim Aufrufer ausdrücklich zuweisen.
Beispiele
<?php
function setResponse(string &$response): void
{
$response = 'ready';
}
$message = 'pending';
echo "Before: $message\n";
setResponse($message);
echo "After: $message\n";
Ergebnis
Before: pending After: ready
Die erste Zeile zeigt `pending`, die zweite `ready`. Der Aufruf ändert `$message`, obwohl die Funktion keinen Wert zurückgibt.
Zugehörige Lektionen
- PHP · Lektion 26 · Mittlere Stufe · Version: 3