CKTIS / PHP
Paramètre passé par référence (`&$response`)
Avec `&$response`, une fonction PHP peut modifier la variable fournie par l’appelant. Le signe `&` figure dans la déclaration du paramètre, pas dans l’appel.
Version : PHP 8.3; extension availability may vary
Syntaxe
function setResponse(string &$response): void { /* Assign to $response here. */ }
setResponse($message);En PHP 8.3, le signe & devant $response indique un passage par référence. Dans setResponse($message), $response et $message désignent la même valeur stockée. Une affectation à $response reste donc visible dans $message après la fin de la fonction. Avec le passage par valeur, qui est le comportement par défaut, cette affectation ne modifierait pas $message.
Écrivez & uniquement dans la déclaration du paramètre, pas devant l’argument. Passez une variable comme $message. L’appel setResponse('pending') provoque une erreur, car un littéral n’est pas une variable. Vous pouvez aussi passer le résultat d’une fonction qui renvoie par référence, mais il ne faut pas passer ainsi un résultat de fonction ordinaire.
$response est un simple nom de paramètre, sans lien avec HTTP. : void signifie que la fonction ne renvoie aucune valeur ; la modification de $message est un effet de bord de l’appel. Si la fonction doit seulement produire une nouvelle valeur, envisagez de la renvoyer et de l’affecter explicitement dans le code appelant.
Exemples
<?php
function setResponse(string &$response): void
{
$response = 'ready';
}
$message = 'pending';
echo "Before: $message\n";
setResponse($message);
echo "After: $message\n";
Résultat
Before: pending After: ready
La première ligne affiche `pending` et la seconde `ready`. L’appel modifie `$message` même si la fonction ne renvoie aucune valeur.
Leçons associées
- PHP · Leçon 26 · Intermédiaire · Version : 3