CKTIS / PHP
Parâmetro passado por referência: &$session
Colocar `&` antes de `$session` permite à função alterar diretamente o array fornecido na chamada. O parâmetro não inicia uma sessão PHP nem guarda os seus dados.
Versão: PHP 8.3; extension availability may vary
Sintaxe
function recordVisit(array &$session): void { /* update $session */ }
recordVisit($state);Em PHP 8.3, com array &$session, o nome local $session e a variável fornecida na chamada referem-se ao mesmo valor. Alterar um elemento ou substituir o array inteiro afeta a variável original, embora a função tenha o tipo de retorno void. Sem &, um array normal é passado por valor por omissão, pelo que essas alterações são locais.
Coloca & na declaração do parâmetro, não na chamada: recordVisit($state). Passa uma variável, não um literal de array como []. O tipo array é verificado à entrada da função, não à saída; um argumento de tipo incorreto provoca um TypeError.
$session é apenas o nome de um parâmetro, não a superglobal $_SESSION. Se a extensão de sessões estiver disponível, podes chamar recordVisit($_SESSION) depois de session_start() terminar com sucesso. É o mecanismo de sessões do PHP que guarda os dados, não &; não contes com o restabelecimento das ligações por referência entre pedidos. O exemplo de consola não precisa da extensão.
Exemplos
<?php
function recordVisit(array &$session): void
{
$session['visits'] = ($session['visits'] ?? 0) + 1;
}
$state = [];
recordVisit($state);
echo $state['visits'], "\n";
recordVisit($state);
echo $state['visits'], "\n";
Resultado
1 2
O array normal `$state` começa vazio. O contador passa a `1` na primeira chamada e a `2` na segunda; não é iniciada nenhuma sessão PHP.
Lições relacionadas
- PHP · Lição 25 · Intermédio · Versão: 3