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

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

Fontes