CKTIS / PHP
Paramètre par référence `&$value` et passage par valeur
En PHP 8.3, le paramètre `&$value` permet à la fonction de modifier la variable de l’appelant. Avec le passage par valeur, utilisé par défaut, affecter le paramètre ne modifie pas cette variable.
Version : PHP 8.3; extension availability may vary
Syntaxe
function addOneByReference(int &$value): void { $value += 1; }
$number = 5;
addOneByReference($number);Dans la déclaration int &$value, & indique un passage par référence. Le paramètre local $value et la variable de l’appelant sont deux noms pour une même valeur ; une référence PHP n’est pas un pointeur au sens du C. Une affectation via $value modifie la valeur chez l’appelant, et la fin de la fonction n’annule pas cette modification.
Écris & dans la déclaration, pas dans l’appel : addOneByReference($number). Passe une variable ou le résultat d’une fonction qui renvoie explicitement par référence. Un littéral comme 5 provoque une erreur ; les expressions ordinaires telles que $number + 1 ne sont pas des arguments valides ici. Un & devant le nom de la fonction indique un retour par référence, pas un paramètre par référence.
Sans &, le passage se fait par valeur : une affectation à $value reste locale. Si l’argument est un objet, les deux variables peuvent tout de même désigner le même objet. Modifier ses propriétés peut donc avoir un effet visible chez l’appelant, mais affecter un autre objet au paramètre ne modifie pas la variable de l’appelant.
Avec int &$value, le type du paramètre est vérifié à l’entrée dans la fonction, pas à la sortie. La déclaration seule ne garantit donc pas qu’une variable ordinaire de l’appelant soit encore de type int après l’appel. Utilise & lorsque la modification de cette variable fait partie du contrat de la fonction, et documente cet effet de bord. Sinon, envisage de renvoyer la nouvelle valeur.
Exemples
<?php
declare(strict_types=1);
function addOneByValue(int $value): void
{
$value += 1;
}
function addOneByReference(int &$value): void
{
$value += 1;
}
$number = 5;
addOneByValue($number);
echo "by value: $number\n";
addOneByReference($number);
echo "by reference: $number\n";
Résultat
by value: 5 by reference: 6
Les deux fonctions exécutent `$value += 1`. Après le passage par valeur, `$number` vaut toujours `5` ; après le passage par référence, il vaut `6`.
Leçons associées
- PHP · Leçon 77 · Avancé · Version : 2