CKTIS / PHP
Parameterübergabe per Referenz (`&$st`)
Ein `&` vor dem Parameternamen erlaubt der Funktion, die Variable des Aufrufers zu ändern. In der Deklaration steht `&$st`; beim Aufruf übergibst du die Variable ohne `&`: `markReady($status)`.
Version: PHP 8.3; extension availability may vary
Syntax
function markReady(string &$st): void { $st .= '!'; }
markReady($status);In PHP 8.3 legt string &$st fest, dass das Argument per Referenz übergeben wird. In der Funktion ist $st ein lokaler Alias für $status aus dem aufrufenden Code: Beide Namen bezeichnen denselben Wert. Schreibst du über $st, ändert sich auch $status, und die Änderung bleibt nach dem Funktionsende sichtbar. Ohne & erfolgt die Übergabe standardmäßig per Wert; eine Zuweisung an den Parameter ändert dann die Variable des Aufrufers nicht.
Das & steht vor dem Parameternamen in der Deklaration, nicht beim Aufruf. Übergib eine initialisierte Variable wie in markReady($status). Das Literal in markReady('Ready') ist keine Variable und führt zu einem Fehler. Übergib auch keine gewöhnlichen Ausdrücke, die einen Wert berechnen. Das Ergebnis einer Funktion, die per Referenz zurückgibt, ist ein eigener zulässiger Fall.
Der Parametertyp string wird beim Eintritt in die Funktion geprüft, beim Verlassen aber nicht erneut. : void bedeutet, dass die Funktion keinen Wert zurückgibt; die Wirkung zeigt sich in der übergebenen Variablen. Verwende &, wenn die Änderung der Aufrufervariablen beabsichtigt ist, und dokumentiere sie, denn am Aufruf selbst ist sie nicht erkennbar.
Beispiele
<?php
function markReady(string &$st): void
{
$st .= '!';
}
$status = 'Ready';
echo $status, "\n";
markReady($status);
echo $status, "\n";
Ergebnis
Ready Ready!
Die erste Zeile lautet `Ready`. Die Funktion hängt über `$st` ein `!` an, daher lautet die zweite Zeile `Ready!`. Entfernst du nur `&` aus der Deklaration, steht in beiden Zeilen `Ready`.
Zugehörige Lektionen
- PHP · Lektion 34 · Mittlere Stufe · Version: 3