PHP: Was Referenzen leisten

Last updated: Fri, 14 Nov 2008

Was Referenzen leisten

PHP Referenzen erlauben es, zwei Variablennamen, sich auf den gleichen Variableninhalt beziehen zu lassen. Das heißt im folgenden Beispiel, dass sich $a und $b auf dieselbe Variable beziehen:


$a =& $b

Hinweis: $a und $b sind hier gleichwertig, und $a ist nicht nur ein Zeiger auf $b oder umgekehrt, sondern $a und $b zeigen auf den selben Inhalt.

Hinweis: Wenn ein Array mit Referenzen kopiert wird, werden seine Werte nicht dereferenziert. Dies gilt auch für Array, die per Wert an Funktionen übergeben werden

Hinweis: Wenn man eine undefinierte Variable per Referenz zuweist, übergibt oder zurückgibt, wird sie erstellt.

Beispiel #1 Referenzen mit undefinierten Variablen benutzen

<?php function foo(&$var) { } foo($a); // $a wird "erstellt" mit dem Wert null $b = array(); foo($b['b']); var_dump(array_key_exists('b', $b)); // bool(true) $c = new StdClass; foo($c->d); var_dump(property_exists($c, 'd')); // bool(true) ?>

Diese Syntax kann auch mit Funktionen, die Referenzen zurückgeben, benutzt werden und seit PHP 4.0.4 auch in Verbindung mit dem new-Operator.


<?php
$bar =& new fooclass();
$foo =& find_var ($bar);
?>

Seit PHP 5 referenziert return new automatisch, also erzeugt die Verwendung der veralteten Syntax =& eine E_STRICT-Warnung.

Hinweis: Wenn der & Operator nicht verwendet wird, erzeugt PHP eine Kopie des Objekts. Wenn nun $this innerhalb der Klasse verwendet wird, bezieht es sich auf die aktuelle Instanz der Klasse. Die Zuordnung ohne & erzeugt eine Kopie der Instanz (d.h. des Objekts) und $this wird sich auf die Kopie beziehen. In der Regel will man aus Performance- und Speicherverbrausgründen nur eine einzige Instanz einer Klasse erzeugen. Dafür stellt PHP den & bereit.
Während man den @-Operator benutzen kann, um Fehler im Konstruktor zu unterdrücken, wenn man ihn als @new benutzt, funktioniert dies nicht bei der Benutzung von &new. Dies ist eine Einschränkung der Zend Engine und resultiert daher in einem Parserfehler.

Warnung

Wenn man einer als global deklarierten Variable eine Referenz innerhalb einer Funktion zuweist, wird die Referenz nur innerhalb der Funktion sichtbar sein. Dies kann durch die Verwendung des $GLOBALS-Arrays vermieden werden.

Beispiel #2 Globale Variablen innerhalb einer Funktion referenzieren


<?php
$var1 = "Example variable";
$var2 = "";

function global_references($use_globals)
{
    global $var1, $var2;
    if (!$use_globals) {
        $var2 =& $var1; // nur innerhalb der Funktion sichtbar
    } else {
        $GLOBALS["var2"] =& $var1; // auch im globalen Kontext sichtbar
    }
}

global_references(false);
echo "var2 is set to '$var2'\n"; // var2 ist ''
global_references(true);
echo "var2 is set to '$var2'\n"; // var2 ist 'Example variable'
?>

Man sollte global $var; als Abkürzung für global $GLOBALS['var']; sehen. Deswegen ändert die Zuweisung per Referenz an $var nur die Referenz der lokalen Variable.

Hinweis: Wenn man einer Variable einen Wert per Referenz in einer foreach-Anweisung zuweist, werden die Referenzen auch geändert.

Beispiel #3 Referenzen und die foreach-Anweisung

<?php $ref = 0; $row =& $ref; foreach (array(1, 2, 3) as $row) { // do something } echo $ref; // 3 - letztes Element des durchlaufenen Arrays ?>

Eine weitere Einsatzmöglichkeit von Referenzen ist die Übergabe von Parametern an eine Funktion mit pass-by-reference. Hierbei beziehen sich der lokale Variablenname als auch der Variablenname der aufrufenden Instanz auf denselben Variableninhalt:


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

$a=5;
foo($a);
?>

Nach der Ausführung hat $a den Wert 6, da sich in der Funktion foo der Variablenname $var auf denselben Variableninhalt bezieht wie $a in der aufrufenden Instanz (hier das Hauptprogramm). Es gibt auch eine detailliertere Erläuterung der Parameterübergabe by-reference

Daneben besteht die Möglichkeit aus Funktionen heraus Werte mit return by-reference zurückzugeben.

Was Referenzen nicht sind

Referenzen in PHP

Last updated: Fri, 14 Nov 2008

add a note User Contributed Notes
Was Referenzen leisten

dnhuff at acm dot org
09-Jun-2008 09:33


In reply to Drewseph using foo($a = 'set'); where $a is a reference formal parameter.



$a = 'set' is an expression. Expressions cannot be passed by reference, don't you just hate that, I do. If you turn on error reporting for E_NOTICE, you will be told about it.



Resolution: $a = 'set'; foo($a); this does what you want.

Drewseph
30-May-2008 02:15


If you set a variable before passing it to a function that takes a variable as a reference, it is much harder (if not impossible) to edit the variable within the function.



Example:

<?php

function foo(&$bar) {

    $bar = "hello\n";

}



foo($unset);

echo($unset);

foo($set = "set\n");

echo($set);



?>



Output:

hello

set



It baffles me, but there you have it.

Amaroq
01-Apr-2008 09:56


The order in which you reference your variables matters.



<?php

$a1 = "One";

$a2 = "Two";

$b1 = "Three";

$b2 = "Four";



$b1 =& $a1;

$a2 =& $b2;



echo $a1; //Echoes "One"

echo $b1; //Echoes "One"



echo $a2; //Echoes "Four"

echo $b2; //Echoes "Four"

?>

charles at org oo dot com
19-Oct-2007 01:59


points to post below me. 

When you're doing the references with loops, you need to unset($var). 



for example 

<?php 

foreach($var as &$value)

{

...

}

unset($value);

?>

Hlavac
09-Oct-2007 12:25


Watch out for this:



foreach ($somearray as &$i) {

  // update some $i...

}

...

foreach ($somearray as $i) {

  // last element of $somearray is mysteriously overwritten!

}



Problem is $i contians reference to last element of $somearray after the first foreach, and the second foreach happily assigns to it!

dovbysh at gmail dot com
06-Jul-2007 10:50


Solution to post "php at hood dot id dot au 04-Mar-2007 10:56":



<?php

$a1 = array('a'=>'a');

$a2 = array('a'=>'b');



foreach ($a1 as $k=>&$v)

$v = 'x';



echo $a1['a']; // will echo x



unset($GLOBALS['v']);



foreach ($a2 as $k=>$v)

{}



echo $a1['a']; // will echo x



?>

amp at gmx dot info
08-Jun-2007 08:59


Something that might not be obvious on the first look:

If you want to cycle through an array with references, you must not use a simple value assigning foreach control structure. You have to use an extended key-value assigning foreach or a for control structure.



A simple value assigning foreach control structure produces a copy of an object or value. The following code



$v1=0;

$arrV=array(&$v1,&$v1);

foreach ($arrV as $v)

{

  $v1++;

  echo $v."\n";

}



yields



0

1



which means $v in foreach is not a reference to $v1 but a copy of the object the actual element in the array was referencing to.



The codes



$v1=0;

$arrV=array(&$v1,&$v1);

foreach ($arrV as $k=>$v)

{

    $v1++;

    echo $arrV[$k]."\n";

}



and



$v1=0;

$arrV=array(&$v1,&$v1);

$c=count($arrV);

for ($i=0; $i<$c;$i++)

{

    $v1++;

    echo $arrV[$i]."\n";

}



both yield



1

2



and therefor cycle through the original objects (both $v1), which is, in terms of our aim, what we have been looking for.



(tested with php 4.1.3)

firespade at gmail dot com
03-Apr-2007 05:11


Here's a good little example of referencing. It was the best way for me to understand, hopefully it can help others.



$b = 2;

$a =& $b;

$c = $a;

echo $c;



// Then... $c = 2

php at hood dot id dot au
05-Mar-2007 08:56


I discovered something today using references in a foreach



<?php

$a1 = array('a'=>'a');

$a2 = array('a'=>'b');



foreach ($a1 as $k=>&$v)

$v = 'x';



echo $a1['a']; // will echo x



foreach ($a2 as $k=>$v)

{}



echo $a1['a']; // will echo b (!)

?>



After reading the manual this looks like it is meant to happen. But it confused me for a few days!



(The solution I used was to turn the second foreach into a reference too)

ladoo at gmx dot at
17-Apr-2005 12:05


I ran into something when using an expanded version of the example of pbaltz at NO_SPAM dot cs dot NO_SPAM dot wisc dot edu below.

This could be somewhat confusing although it is perfectly clear if you have read the manual carfully. It makes the fact that references always point to the content of a variable perfectly clear (at least to me).



<?php

$a = 1;

$c = 2;

$b =& $a; // $b points to 1

$a =& $c; // $a points now to 2, but $b still to 1;

echo $a, " ", $b;

// Output: 2 1

?>

php.devel at homelinkcs dot com
16-Nov-2004 01:16


In reply to lars at riisgaardribe dot dk, 



When a variable is copied, a reference is used internally until the copy is modified.  Therefore you shouldn't use references at all in your situation as it doesn't save any memory usage and increases the chance of logic bugs, as you discoved.

joachim at lous dot org
11-Apr-2003 01:46


So to make a by-reference setter function, you need to specify reference semantics _both_ in the parameter list _and_ the assignment, like this:



class foo{

   var $bar;

   function setBar(&$newBar){

      $this->bar =& newBar;

   }

}



Forget any of the two '&'s, and $foo->bar will end up being a copy after the call to setBar.

add a note

Was Referenzen nicht sind

Referenzen in PHP

Last updated: Fri, 14 Nov 2008