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