Parameterübergabe per Referenz

Man kann Variablen an Funktionen per Referenz übergeben, so dass die Funktion ihre Argumente modifizieren kann. Dazu benutzt man folgende Syntax:

<?php
function foo(&$var)
{
    
$var++;
}

$a=5;
foo($a);
// $a ist 6
?>

Hinweis: Zu beachten ist, dass kein Referenz-Zeichen beim Funktionsaufruf steht, nur in der Funktionsdefinition. Diese allein ist ausreichend, um das Argument per Referenz zu übergeben. Von PHP 5.3.0 an gibt es eine Warnung, dass die Benutzung von "Call-time pass-by-reference" mit Hilfe von & in foo(&$a); missbilligt ist. Und von PHP 5.4.0 an ist call-time pass-by-reference entfernt, so dass die Verwendung einen fatalen Fehler auslöst.

Folgende Dinge können per Referenz übergeben werden:

  • Variablen, zum Beispiel foo($a)
  • Referenzen, zurückgegeben von einer Funktion, zum Beispiel:

    <?php
    function foo(&$var)
    {
        
    $var++;
    }
    function &
    bar()
    {
        
    $a 5;
        return 
    $a;
    }
    foo(bar());
    ?>
    Es gibt detailliertere Erläuterungen zur Rückgabe by-reference.

Alle anderen Ausdrücke sollten nicht per Referenz übergeben werden, da das Ergebnis undefiniert ist. Folgende Beispiele sind etwa ungültig:

<?php
function foo(&$var)
{
    
$var++;
}
function 
bar() // Beachte das fehlende &
{
    
$a 5;
    return 
$a;
}
foo(bar()); // Erzeugt einen fatalen Fehler von PHP 5.0.5 an, einen Strikt-Standards-Hinweis
            // von PHP 5.1.1 an, und einen Hinweis von PHP 7.0.0 an

foo($a 5); // Ausdruck, nicht Variable
foo(5); // Erzeugt einen fatalen Fehler

class Foobar
{
}

foo(new Foobar()) // Erzeugt einen Hinweis von PHP 7.0.7 an
                  // Notice: Only variables should be passed by reference
?>