Para empezar.
Debemos tener claro qué es una referencia en PHP.
De acuerdo a un pequeño fragmento en la documentación oficial de PHP.
Las referencias de PHP permiten hacer que dos variables hagan referencia al mismo contenido.
Miremos este ejemplo:
<?php
$variableA = "Hola mundo!";
$variableB = $variableA;
$variableA = "Hola amigos!";
print "A: " . $variableA . "\n";
print "B: " . $variableB . "\n";
?>
El resultado que obtendremos será:
A: Hola amigos!
B: Hola mundo!
Pero ahora, agreguemos un ampersand (&) a nuestro codigo y miremos qué ocurre:
<?php
$variableA = "Hola mundo!";
$variableB =& $variableA; /* Agregamos el & */
$variableA = "Hola amigos!";
print "A: " . $variableA . "\n";
print "B: " . $variableB . "\n";
?>
El resultado que obtendremos será:
A: Hola amigos!
B: Hola amigos!
¿Qué nos quiere decir esto?
Hemos usado un operador para acceder al mismo valor de otra variable y usarlo, lo hemos modificado, pero al modificarlo se modificó el valor de la variable original, en este caso $variableA
.
$variableB =& $variableA;
Esto se conoce como Asignación por referencia.
En ese orden de ideas
Podemos ver un ejemplo sencillo de una función usando las referencias:
<?php
function caminar($X){
$X++;
}
$pasos = 0;
caminar($pasos);
caminar($pasos);
caminar($pasos);
print "He caminado $pasos pasos\n";
?>
El resultado de este programa será:
He caminado 0 pasos
Y volvemos a usar el operador ampersand (&) y veremos como ocurre la magia.
<?php
function caminar(&$X){ /* Agregamos el & */
$X++;
}
$pasos = 0;
caminar($pasos);
caminar($pasos);
caminar($pasos);
print "He caminado $pasos pasos\n";
?>
Y el nuevo resultado es:
He caminado 3 pasos
Al igual que el ejemplo anterior, lo que hemos hecho acá es pasar una referencia a una variable externa a la función, y a través de esa referencia la hemos modificado, incrementando su valor en cada llamado a la funcion caminar()
.
Esto lo conocemos como Paso por referencia.
Por último
El operador ampersand (&), delante del nombre de una función, retorna una referencia, en lugar de un valor.
Esto se conoce como retorno de referencias.
¿Esto qué significa?
Miremos este ejemplo:
<?php
$variable = "StackOverflow";
function &obtenerReferencia(){
global $variable;
return $variable;
}
$puntero = &obtenerReferencia();
$puntero = "Stack Overflow Rules!";
print $variable;
?>
Hemos inicializado el valor de $variable
con el texto "StackOverflow", pero cuando ejecutamos el programa, obtenemos el siguiente resultado:
Stack Overflow Rules!
Lo que ha ocurrido es que en la variable $puntero
hemos guardado una referencia a la posición en memoria de la variable $variable
, que contiene nuestro texto original. Al obtener la referencia a dicha variable hace que cualquier cambio que hagamos en la misma afecte a la variable original.
He hecho una modificación a tu ejemplo, respondiendo a la pregunta de por qué imprime lo mismo:
<?php
class Cartera {
public $dinero = 93;
public function &muestraLaPasta() { // Si quito este ampersand
return $this->dinero;
}
}
$carteraDeMaria = new Cartera;
$miPastaGansa = &$carteraDeMaria->muestraLaPasta(); // y este
echo $miPastaGansa . "\n"; // el resultado es el mismo
// Cuanto dinero tiene Maria
echo $carteraDeMaria->dinero . "\n";
// Cuanto dinero tiene Maria ahora
$miPastaGansa = 5000;
echo $carteraDeMaria->dinero . "\n";
?>
Obtenemos como resultado:
93
93
5000
¿Qué ocurrió aquí?
Al imprimir el valor retornado de una función de referencia muestraLaPasta()
, el valor quedará siempre intacto. Lo que cambia es el origen de ese valor, en ese caso, he agregado este par de líneas:
$miPastaGansa = 5000;
echo $carteraDeMaria->dinero . "\n";
Modificando la referencia de ellas $miPastaGansa
, que para este caso es un "puntero" hacia el atributo $dinero
. Lo que nos dará posteriormente el valor de 5000, cuando obtengamos el valor del atributo $dinero
.