WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen