Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

Atribuição por referência: `$session = &getSession()`

Aprende como os dois sinais `&` criam um alias para uma variável devolvida por uma função e por que razão isso não inicia uma sessão PHP.

Versão: PHP 8.3; extension availability may vary

Sintaxe

function &getSession(): array {
    static $data = [];
    return $data;
}

$session = &getSession();

Em PHP 8.3, $session = &getSession() associa $session ao conteúdo da variável devolvida, em vez de lhe atribuir apenas o valor. Ambos os nomes acedem ao mesmo conteúdo, pelo que as alterações feitas através de um são visíveis através do outro. getSession() chama a função sem argumentos. Por outro lado, getSession(...) cria um objeto Closure sem chamar a função.

São necessários dois sinais &: o que precede o nome em function &getSession(): array declara a devolução por referência e o que se segue a = associa o resultado a $session. Não se trata de um AND bit a bit nem de uma passagem de argumentos por referência. Devolve uma variável, como em return $data;, não um literal nem o resultado de um cálculo. Se a função devolver por valor, acrescentar & apenas na atribuição gera uma mensagem de diagnóstico e não cria um alias.

Neste exemplo, getSession() é uma função definida no espaço de nomes global, não uma função incorporada no PHP. O seu array local static mantém o valor entre chamadas na mesma execução do script. $copy = getSession(); não cria um alias: alterar o contador na cópia não modifica o array guardado. unset($session) remove o nome do alias, não o array. Devolve uma referência quando o código que chama a função deva alterar o conteúdo partilhado, não por motivos de desempenho.

O exemplo não usa $_SESSION nem a extensão de sessões. Para uma sessão real que ainda não esteja ativa, verifica se session_start() foi bem-sucedida antes de depender de $_SESSION. A disponibilidade da extensão depende da instalação. Guarda dados da sessão, não alias que esperas que persistam entre pedidos.

Exemplos

<?php
function &getSession(): array
{
    static $data = ['count' => 0];
    return $data;
}

$session = &getSession();
$session['count']++;

$copy = getSession();
$copy['count'] = 9;

echo 'stored=', getSession()['count'], "\n";
echo 'copy=', $copy['count'], "\n";

unset($session);
echo 'after unset=', getSession()['count'], "\n";

Resultado

stored=1
copy=9
after unset=1

Incrementar o contador através de `$session` deixa o valor guardado em `1`. Só a cópia fica com `9`; depois de `unset($session)`, o contador guardado continua a valer `1`.

Lições relacionadas

  • PHP · Lição 25 · Intermédio · Versão: 3

Fontes