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

CKTIS / PHP

Paramètre passé par référence (`&$st`)

Le signe `&` devant le nom du paramètre permet à la fonction de modifier la variable du code appelant. Écrivez `&$st` dans la déclaration, mais appelez la fonction sans `&` : `markReady($status)`.

Version : PHP 8.3; extension availability may vary

Syntaxe

function markReady(string &$st): void { $st .= '!'; }
markReady($status);

En PHP 8.3, string &$st indique que l’argument est passé par référence. Dans la fonction, $st est un alias local de $status, la variable du code appelant : les deux noms désignent la même valeur. Écrire via $st modifie donc $status, et la modification reste visible après la fin de la fonction. Sans &, le passage se fait par valeur par défaut : une affectation au paramètre ne modifie pas la variable du code appelant.

Placez & devant le nom du paramètre dans la déclaration, et non dans l’appel. Passez une variable initialisée, comme dans markReady($status). Le littéral dans markReady('Ready') n’est pas une variable et provoque une erreur. Ne passez pas non plus d’expression ordinaire qui calcule une valeur ; le résultat d’une fonction qui renvoie par référence est un cas distinct autorisé.

Le type string du paramètre est vérifié à l’entrée dans la fonction, mais pas de nouveau à la sortie. : void signifie que la fonction ne renvoie aucune valeur ; l’effet est visible sur la variable passée. Utilisez & lorsque cette modification est voulue et documentez-la, car l’appel seul ne la signale pas.

Exemples

<?php
function markReady(string &$st): void
{
    $st .= '!';
}

$status = 'Ready';
echo $status, "\n";
markReady($status);
echo $status, "\n";

Résultat

Ready
Ready!

La première ligne affiche `Ready`. La fonction ajoute `!` via `$st`, donc la seconde ligne affiche `Ready!`. Si vous retirez uniquement `&` de la déclaration, les deux lignes affichent `Ready`.

Leçons associées

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

Sources