CKTIS / PHP
Atribuição por referência (`=&`) em PHP
`=&` vincula dois nomes ao mesmo conteúdo de uma variável. Enquanto ambos estiverem vinculados, uma escrita através de um nome é visível através do outro.
Versão: PHP 8.3; extension availability may vary
Sintaxe
$alias =& $source;
$alias = &$source; // Equivalent spacingEm PHP 8.3, $alias =& $source e $alias = &$source vinculam os dois nomes ao mesmo conteúdo de uma variável. Nenhum dos nomes aponta para o outro como faria um ponteiro em C. Não confundas =& com &=, que executa um AND bit a bit e atribui o resultado.
$copy = $source lê o valor atual sem tornar $copy um alias de $source. Se $copy já for um alias de outra variável, = escreve no conteúdo partilhado. Ao atribuir um objeto com =, as duas variáveis podem identificar o mesmo objeto, mas substituir o valor de uma não altera, por si só, o valor da outra.
À direita, usa uma variável, um elemento de um array ou uma chamada a uma função declarada para devolver uma variável por referência. Um literal, um valor calculado e uma expressão new não são fontes de referência válidas. Tentar criar um vínculo ao resultado de uma chamada que devolve por valor emite E_NOTICE e não cria um alias. Vincular uma variável não definida cria-a com o valor null; inicializa-a primeiro se não pretenderes esse efeito.
$alias =& $other apenas muda o vínculo de $alias. unset($alias) remove só esse nome; os restantes aliases continuam a poder aceder ao conteúdo. Em contrapartida, $alias = null escreve null no conteúdo partilhado.
Copiar um array com = pode preservar as referências de elementos individuais. Se foreach ($items as &$value) visitar pelo menos um elemento, $value permanece vinculado ao último elemento visitado após o ciclo, mesmo que break interrompa o ciclo antes do fim do array. Usa unset($value) logo após o ciclo para evitar que uma escrita posterior altere esse elemento inadvertidamente.
Exemplos
<?php
$source = 10;
$alias =& $source;
$copy = $source;
$alias = 20;
echo "$source $alias $copy\n";
$source = 30;
echo "$source $alias $copy\n";
unset($alias);
$alias = 40;
echo "$source $alias $copy\n";
Resultado
20 20 10 30 30 10 30 40 10
As duas primeiras linhas mostram que uma escrita através de qualquer um dos nomes vinculados é visível através do outro, enquanto `$copy` mantém o valor `10`. Após `unset($alias)`, atribuir `40` já não altera `$source`.
Lições relacionadas
- PHP · Lição 80 · Avançado · Versão: 2