CKTIS / PHP
Paramètre passé par référence (`&$projects`)
Avec `&$projects`, une fonction peut modifier la variable du code appelant. Le `&` s’écrit dans la déclaration du paramètre, pas dans l’appel.
Version : PHP 8.3; extension availability may vary
Syntaxe
function addProject(array &$projects, string $name): void { $projects[] = $name; }
addProject($activeProjects, 'Beacon');En PHP 8.3, array &$projects déclare un paramètre passé par référence. Pendant l’appel, $projects dans la fonction et $activeProjects dans le code appelant sont deux noms pour le même contenu. Ajouter un élément avec $projects[] = $name ou affecter un tout nouveau tableau à $projects modifie la variable du code appelant. La modification reste visible après l’appel ; void indique que la fonction ne renvoie pas de résultat.
Écris & uniquement dans la déclaration du paramètre. Appelle addProject($activeProjects, 'Beacon') sans &. Passe une variable initialisée plutôt qu’un tableau littéral comme [], qui provoque une erreur à cet emplacement. On peut aussi passer une référence renvoyée par une fonction ; une valeur de retour ordinaire ne remplace pas une variable.
PHP vérifie le type array à l’entrée de la fonction, pas à la sortie. Si la variable initialisée ne contient pas un tableau, l’appel déclenche une TypeError. La déclaration du paramètre ne garantit toutefois pas que la fonction laisse un tableau dans la variable.
Sans &, l’argument est passé par valeur par défaut : dans cet exemple, l’ajout ne modifierait que le tableau local. Utilise une référence si la modification de la variable du code appelant est volontaire, et documente cet effet. Si la variable doit rester intacte, passe le tableau par valeur et renvoie un tableau mis à jour.
Exemples
<?php
function addProject(array &$projects, string $name): void
{
$projects[] = $name;
}
$activeProjects = ['Atlas'];
echo implode(', ', $activeProjects), "\n";
addProject($activeProjects, 'Beacon');
echo implode(', ', $activeProjects), "\n";
Résultat
Atlas Atlas, Beacon
La première ligne montre l’état avant l’appel. La seconde montre que `Beacon` a été ajouté à `$activeProjects`, même si `addProject()` ne renvoie aucun résultat.
Leçons associées
- PHP · Leçon 12 · Intermédiaire · Version : 3
- PHP · Leçon 13 · Intermédiaire · Version : 3