CKTIS / PHP
Paramètre passé par référence : &$session
Placer `&` devant `$session` permet à la fonction de modifier directement le tableau fourni par l’appelant. Cela ne démarre pas de session PHP et n’enregistre aucune donnée de session.
Version : PHP 8.3; extension availability may vary
Syntaxe
function recordVisit(array &$session): void { /* update $session */ }
recordVisit($state);En PHP 8.3, avec array &$session, le nom local $session et la variable fournie par l’appelant désignent la même valeur. Modifier un élément ou remplacer le tableau entier affecte la variable de l’appelant, même si le type de retour est void. Sans &, un tableau ordinaire est passé par valeur par défaut : ces modifications restent locales.
Placez & dans la déclaration du paramètre, pas dans l’appel : recordVisit($state). Passez une variable, pas un littéral de tableau comme []. Le type array est contrôlé à l’entrée de la fonction, pas à sa sortie ; un argument de type incorrect déclenche une erreur TypeError.
$session est un simple nom de paramètre, pas la superglobale $_SESSION. Si l’extension de sessions est disponible, vous pouvez appeler recordVisit($_SESSION) après la réussite de session_start(). C’est le mécanisme de session de PHP qui enregistre les données, et non & ; ne comptez pas sur la restauration des liens de référence entre les requêtes. L’exemple en console n’a pas besoin de cette extension.
Exemples
<?php
function recordVisit(array &$session): void
{
$session['visits'] = ($session['visits'] ?? 0) + 1;
}
$state = [];
recordVisit($state);
echo $state['visits'], "\n";
recordVisit($state);
echo $state['visits'], "\n";
Résultat
1 2
Le tableau ordinaire `$state` est vide au départ. Son compteur vaut `1` après le premier appel et `2` après le second ; aucune session PHP n’est démarrée.
Leçons associées
- PHP · Leçon 25 · Intermédiaire · Version : 3