Isso se trata do Operador de Refência.
De acordo com o PHP
Referências, em PHP, significa acessar o mesmo conteúdo de variável através de vários nomes
Veja um exemplo:
$a = 1;
$b = $a;
$a = 2;
var_dump($a, $b); // a => 2, b => 1
Agora um exemplo com o operador de referência:
$a = 1
$b =& $a;
$a = 2;
var_dump($a, $b)/ // a= > 2, b => 2
Ou seja, $b
aponta para o valor de $a
. Ele não tem um valor independente, mas ele aponta para o local da memória onde o valor de $a
foi salvo.
No caso das funções, O operador &
pode ser utilizado de duas formas:
Vou dar um exemplo de passagem por referência nas funções:
$meuValor = [1, 2, 3];
function my_function(&$var, $add){
$var[] = $add;
}
my_function($meuValor, 6);
print_($meuValor); // [1, 2, 3, 6];
Veja que o valor de $meuValor
foi alterado, sem o return
dentro da função e sem a reatribuição da mesma pelo retorno de my_function
.
Isso acontece porque $var
passa ser referência da variável passada por parâmetro; ou seja, a variável $meuValor
.
A utilização no Operador new
foi desencorajada, e, se não me engano, gera um erro E_STRICT
ao tentar fazer.
Isso ocorria nas versões anteriores ao PHP 5.
Nas versões novas do PHP, os objetos são passados por referência por padrão.