CKTIS / PHP
Capturer une variable par référence dans une fermeture PHP : `use (&$carry)`
Avec `use (&$carry)`, une fermeture et sa portée de définition peuvent lire et modifier la même variable. Sans `&`, la fermeture capture la valeur au moment de sa création.
Version : PHP 8.3; extension availability may vary
Syntaxe
$carry = 0;
$add = function (int $item) use (&$carry): void {
$carry += $item;
};En PHP 8.3, use (&$carry) se place après la liste des paramètres d’une fonction anonyme et avant son éventuel type de retour. Avec &, les deux occurrences de $carry désignent le même contenu. Une affectation d’un côté est visible de l’autre. La capture se fait dans la portée de définition, pas dans celle de l’appel. $carry est un nom de variable ordinaire, pas un mot-clé.
use ($carry) capture la valeur à la création : une affectation ultérieure à la variable entière externe ne change pas ce que lit la fermeture. Une fonction fléchée (fn) capture automatiquement par valeur. Cette clause use n’importe pas de noms d’un espace de noms. Elle se distingue aussi d’un paramètre par référence (function (&$carry)) et d’un retour par référence (function &()). La liste use ne peut contenir ni $this, ni variable superglobale, ni nom déjà utilisé comme paramètre.
Initialisez $carry avant de créer la fermeture. Celle-ci peut garder accès à l’état capturé après la fin de la fonction qui l’a créée. Hors de la fermeture, unset($carry) supprime la liaison externe, pas l’état auquel la fermeture accède encore ; réaffecter ce nom ne rétablit pas la liaison. Réservez la référence aux cas où le partage d’un état modifiable est voulu : l’expression d’appel à elle seule n’indique pas que la fermeture modifie $carry, mais après l’appel, on peut lire la valeur mise à jour dans la variable externe $carry.
Le paramètre $carry du rappel de array_reduce() est différent : il reçoit d’abord la valeur initiale, puis la valeur renvoyée par le rappel à l’itération précédente. Pour une réduction simple, renvoyez l’accumulateur mis à jour plutôt que de capturer une variable externe. La syntaxe use (&$carry) ne nécessite aucune extension supplémentaire.
Exemples
<?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";
Résultat
2 0 15
`$add(2)` porte le `$carry` externe à `2`. Après l’ajout externe de `10`, `$add(3)` lit `12` et écrit `15`. `$snapshot()` renvoie toujours `0`, car la valeur a été capturée à la création.
Leçons associées
- PHP · Leçon 15 · Avancé · Version : 2