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

CKTIS / PHP

Retour par référence : `function &getSession`

Une fonction qui retourne par référence permet au code appelant de créer un alias d’une variable. `=&` établit ce lien ; `=` affecte la valeur sans créer d’alias.

Version : PHP 8.3; extension availability may vary

Syntaxe

function &getSession(): array { static $state = []; return $state; }
$alias = &getSession(); // Bind an alias to the returned variable.
$copy = getSession();   // Assign the array by value.

En PHP 8.3, le & devant le nom dans function &getSession(): array indique un retour par référence. array précise le type de retour. Écris return $state; pour désigner la variable, sans ajouter de & après return. Un littéral ou un résultat de calcul n’est pas une variable et ne peut pas être correctement renvoyé par référence.

$alias = &getSession(); lie un autre nom à la même variable. Modifier $alias['visits'] modifie le tableau stocké. En revanche, $copy = getSession(); affecte le tableau par valeur : modifier $copy['visits'] ne change pas l’original. Il ne s’agit pas de passer un argument par référence : le & de la déclaration concerne le résultat, et =& lie l’alias du côté appelant.

getSession() est définie dans l’exemple ; ce n’est pas une API de session intégrée. Sa variable locale static conserve sa valeur entre les appels d’une même exécution, mais ne stocke pas de données d’une requête à l’autre. L’exemple ne nécessite pas l’extension de gestion des sessions. Pour démarrer ou reprendre manuellement une vraie session PHP, la prise en charge des sessions doit être disponible et l’appel à session_start() doit réussir ; les données de session sont accessibles dans $_SESSION.

Ne renvoie une référence que si le code appelant doit pouvoir modifier directement l’état interne, et non pour améliorer les performances. Si les modifications doivent être validées, propose une fonction de mise à jour distincte plutôt qu’un alias modifiable.

Exemples

<?php
function &getSession(): array
{
    static $state = ['visits' => 1];
    return $state;
}

$copy = getSession();
$alias = &getSession();

$alias['visits']++;
$copy['visits'] += 10;

$current = getSession();
echo 'Stored: ', $current['visits'], "\n";
echo 'Copy: ', $copy['visits'], "\n";

Résultat

Stored: 2
Copy: 11

La modification via l’alias porte la valeur stockée de `visits` à `2`. La copie a été faite avant : lui ajouter `10` donne `11` sans modifier l’original.

Leçons associées

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

Sources