CKTIS / PHP
Parâmetro passado por referência (`&$response`)
Com `&$response`, uma função PHP pode alterar a variável fornecida pelo código que a chama. O símbolo `&` escreve-se na declaração do parâmetro, não na chamada.
Versão: PHP 8.3; extension availability may vary
Sintaxe
function setResponse(string &$response): void { /* Assign to $response here. */ }
setResponse($message);Em PHP 8.3, o símbolo & antes de $response indica a passagem por referência. Em setResponse($message), $response e $message referem-se ao mesmo valor armazenado. Por isso, uma atribuição a $response é visível em $message mesmo depois de a função terminar. Na passagem por valor, que é o comportamento predefinido, essa atribuição não alteraria $message.
Escreve & apenas na declaração do parâmetro, não antes do argumento. Passa uma variável como $message. A chamada setResponse('pending') gera um erro, porque um literal não é uma variável. Também podes passar o resultado de uma função que devolva por referência, mas não deves passar desta forma o resultado normal de uma função.
$response é um nome de parâmetro comum, sem ligação ao HTTP. : void significa que a função não devolve nenhum valor; a alteração de $message é um efeito secundário da chamada. Se a função só tiver de produzir um novo valor, considera devolvê-lo e atribuí-lo explicitamente no código que faz a chamada.
Exemplos
<?php
function setResponse(string &$response): void
{
$response = 'ready';
}
$message = 'pending';
echo "Before: $message\n";
setResponse($message);
echo "After: $message\n";
Resultado
Before: pending After: ready
A primeira linha mostra `pending` e a segunda mostra `ready`. A chamada altera `$message`, embora a função não devolva nenhum valor.
Lições relacionadas
- PHP · Lição 26 · Intermédio · Versão: 3