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

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

Fontes