Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / PHP

Catturare una variabile per riferimento in una closure PHP: `use (&$carry)`

Con `use (&$carry)`, una closure e l’ambito in cui è definita possono leggere e modificare la stessa variabile. Senza `&`, la closure cattura il valore al momento della creazione.

Versione: PHP 8.3; extension availability may vary

Sintassi

$carry = 0;
$add = function (int $item) use (&$carry): void {
    $carry += $item;
};

In PHP 8.3, use (&$carry) si scrive dopo l’elenco dei parametri di una funzione anonima e prima dell’eventuale tipo di ritorno. Con &, le due occorrenze di $carry fanno riferimento allo stesso contenuto. Un’assegnazione da una parte è visibile dall’altra. La closure cattura la variabile dall’ambito di definizione, non da quello della chiamata. $carry è un normale nome di variabile, non una parola chiave.

use ($carry) cattura il valore alla creazione: assegnare in seguito un altro valore alla variabile intera esterna non cambia ciò che legge la closure. Una funzione freccia (fn) cattura automaticamente per valore. Questa clausola use non importa nomi da un namespace. È diversa anche da un parametro per riferimento (function (&$carry)) o da un ritorno per riferimento (function &()). Nell’elenco use non sono ammessi $this, le superglobali e i nomi già usati come parametri.

Inizializza $carry prima di creare la closure. La closure può conservare l’accesso allo stato catturato dopo che la funzione che l’ha creata è terminata. All’esterno della closure, unset($carry) rimuove il legame esterno, non lo stato ancora accessibile alla closure; riassegnare quel nome non ripristina il legame. Usa i riferimenti quando vuoi condividere uno stato modificabile: la sola espressione di chiamata non mostra che la closure modifica $carry, ma dopo la chiamata si può leggere il valore aggiornato della variabile esterna $carry.

Il parametro $carry del callback di array_reduce() è diverso: riceve prima il valore iniziale e poi il valore restituito dal callback all’iterazione precedente. Per una riduzione semplice, restituisci l’accumulatore aggiornato invece di catturare una variabile esterna. La sintassi use (&$carry) non richiede estensioni aggiuntive.

Esempi

<?php
$carry = 0;
$snapshot = function () use ($carry): int {
    return $carry;
};
$add = function (int $item) use (&$carry): void {
    $carry += $item;
};

$add(2);
echo $carry, "\n";
$carry += 10;
$add(3);
echo $snapshot(), "\n", $carry, "\n";

Risultato

2
0
15

`$add(2)` porta il `$carry` esterno a `2`. Dopo che il codice esterno ha aggiunto `10`, `$add(3)` legge `12` e scrive `15`. `$snapshot()` restituisce ancora `0` perché ha catturato il valore alla creazione.

Lezioni correlate

  • PHP · Lezione 15 · Avanzato · Versione: 2

Fonti