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

CKTIS / PHP

Capture par référence dans une fermeture PHP : `use (&$vat)`

En PHP, `use (&$vat)` permet à une fermeture de partager une variable avec sa portée de création. Sans `&`, la fermeture conserve la valeur scalaire présente à sa création.

Version : PHP 8.3; extension availability may vary

Syntaxe

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

use (&$vat) capture $vat par référence dans la portée où la fermeture est créée, pas dans celle où elle est appelée. Le $vat interne et le $vat externe sont deux alias de la même variable : une affectation à l’extérieur est visible à l’intérieur, et une affectation à l’intérieur modifie la valeur visible à l’extérieur. Ici, & indique une capture par référence, pas un paramètre passé par référence ni un ET bit à bit. Cette clause use n’importe pas de noms d’espaces de noms.

use ($vat) capture par valeur. Pour un entier, la fermeture conserve la valeur à sa création, pas à son appel. Les affectations ultérieures à l’extérieur ne modifient pas la valeur capturée, et les affectations à l’intérieur ne modifient pas la variable externe. La capture par valeur ne fait pas de copie profonde : on peut toujours modifier les propriétés du même objet.

En PHP 8.3, la clause use se place après la liste des paramètres et avant l’éventuel type de retour. Dans la syntaxe présentée, la valeur de $vat renvoyée à l’appel de la fermeture doit respecter le type de retour déclaré int. La liste de capture ne peut contenir ni $this, ni superglobales, ni noms de paramètres. La fermeture peut conserver l’accès à la valeur capturée après la sortie de sa portée de création. Un unset($vat) à l’extérieur supprime seulement la liaison externe ; la fermeture garde accès à la valeur partagée.

N’utilisez une référence que si le partage d’un état modifiable est volontaire : le résultat d’un appel peut alors dépendre des écritures précédentes et de l’ordre des appels.

Exemples

<?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";

Résultat

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

Après l’affectation externe de `23`, `$live()` renvoie `23` tandis que `$snapshot()` renvoie toujours `20`. L’appel à `$bump()` porte la valeur partagée à `24`, ce que montrent aussi bien le `$vat` externe que `$live()`.

Leçons associées

  • PHP · Leçon 4 · Avancé · Version : 2

Sources