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

CKTIS / PHP

Captura por referência numa clausura PHP: `use (&$vat)`

Em PHP, `use (&$vat)` permite que uma clausura partilhe uma variável com o âmbito onde foi criada. Sem `&`, a clausura conserva o valor escalar que a variável tinha no momento da criação.

Versão: PHP 8.3; extension availability may vary

Sintaxe

$closure = function () use (&$vat): int { return $vat; };

use (&$vat) captura $vat por referência a partir do âmbito em que a clausura é criada, não daquele em que é chamada. O $vat interno e o externo são aliases da mesma variável: uma atribuição fora é visível dentro, e uma atribuição dentro altera o valor visível fora. Aqui, & indica captura por referência, não um parâmetro por referência nem um AND bit a bit. Esta cláusula use não importa nomes de espaços de nomes.

use ($vat) captura por valor. Para um inteiro, a clausura conserva o valor do momento da criação, não da chamada. Atribuições posteriores no exterior não alteram o valor capturado e atribuições no interior não alteram a variável externa. A captura por valor não faz uma cópia profunda: se for capturado um objeto, continua a ser possível alterar propriedades desse mesmo objeto.

Em PHP 8.3, a cláusula use fica depois da lista de parâmetros e antes do tipo de retorno, se este for declarado. Na sintaxe apresentada, quando a clausura é chamada, o valor devolvido a partir de $vat tem de respeitar o tipo de retorno declarado int. A lista de captura não pode incluir $this, variáveis superglobais nem nomes de parâmetros. A clausura pode continuar a aceder ao valor capturado após a saída do âmbito em que foi criada. Chamar unset($vat) no exterior remove apenas a ligação externa; a clausura mantém o acesso ao valor partilhado.

Usa uma referência apenas quando queres partilhar um estado modificável: o resultado de uma chamada pode então depender de escritas anteriores e da ordem das chamadas.

Exemplos

<?php
$vat = 20;

$snapshot = function () use ($vat): int {
    return $vat;
};

$live = function () use (&$vat): int {
    return $vat;
};

$bump = function () use (&$vat): void {
    $vat += 1;
};

$vat = 23;
echo 'snapshot=', $snapshot(), ' live=', $live(), "\n";

$bump();
echo 'outer=', $vat, ' live=', $live(), ' snapshot=', $snapshot(), "\n";

Resultado

snapshot=20 live=23
outer=24 live=24 snapshot=20

Após a atribuição externa de `23`, `$live()` devolve `23`, enquanto `$snapshot()` continua a devolver `20`. A chamada a `$bump()` aumenta o valor partilhado para `24`, visível tanto no `$vat` externo como através de `$live()`.

Lições relacionadas

  • PHP · Lição 4 · Avançado · Versão: 2

Fontes