Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / PHP

Capturer une variable par référence dans une fermeture : `use (&$MAP)`

`use (&$MAP)` permet à une fonction anonyme de lire et de modifier l’état actuel de `$MAP` dans la portée où elle a été définie.

Version : PHP 8.3; extension availability may vary

Syntaxe

$increment = function (string $key) use (&$MAP): int {
    return ++$MAP[$key];
};

En PHP 8.3, use (&$MAP) se place après la liste des paramètres de la fonction anonyme et avant son éventuel type de retour. $MAP est un nom de variable ordinaire. Dans l’exemple, cette variable contient un tableau associatif qui associe des clés à des valeurs. Ici, & indique une référence et non une opération bit à bit.

La liaison est établie à la création de la fermeture, dans sa portée de définition et non dans celle de l’appelant. Tant que les deux liaisons subsistent, remplacer le tableau à l’extérieur est visible à l’intérieur, et modifier une entrée à l’intérieur est visible à l’extérieur. À l’inverse, use ($MAP) capture par valeur le tableau d’entiers tel qu’il est à la création de la fermeture. Une fonction fléchée (fn) capture automatiquement par valeur les variables extérieures qu’elle utilise.

Cette clause use n’est pas un import d’espace de noms. Ce n’est pas non plus un paramètre par référence comme dans function (array &$map), qui se lie à une variable fournie à l’appel. Dans l’exemple, le seul argument est la clé.

La fermeture peut conserver l’accès à l’état capturé après la sortie de sa portée de définition. Un unset($MAP) à l’extérieur ne supprime que la liaison extérieure ; recréer $MAP ne la reconnecte pas à la fermeture existante. Initialisez le tableau avant de le capturer. N’utilisez & que si la fonction doit partager son état avec le code qui l’entoure.

Exemples

<?php
$MAP = ['apples' => 1];

$readSnapshot = function () use ($MAP): int {
    return $MAP['apples'];
};

$increment = function (string $key) use (&$MAP): int {
    return ++$MAP[$key];
};

$MAP = ['apples' => 2];
echo $readSnapshot(), "\n";
echo $increment('apples'), "\n";
echo $MAP['apples'], "\n";

Résultat

1
3
3

La première lecture donne `1`, issu du tableau capturé par valeur. Après le remplacement du tableau, la fermeture qui capture par référence lit `2` et incrémente l’entrée existante `apples` jusqu’à `3`. La lecture extérieure donne elle aussi `3`. L’exemple ne nécessite aucune extension supplémentaire.

Leçons associées

  • PHP · Leçon 36 · Intermédiaire · Version : 3

Sources