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

CKTIS / PHP

Paramètre tableau passé par référence : `array &$items`

`array &$items` exige un tableau au début de l’appel et permet à la fonction de modifier la variable de l’appelant sans renvoyer de résultat.

Version : PHP 8.3; extension availability may vary

Syntaxe

function markReady(array &$items): void { $items[0] = 'ready'; }
$cart = ['draft'];
markReady($cart);

Dans function markReady(array &$items): void, array déclare le type attendu en entrée, $items est le nom local du paramètre et & indique un passage par référence. Le paramètre est un alias de la variable de l’appelant : modifier $items[0] ou affecter une nouvelle valeur à $items a un effet visible chez l’appelant, même avec : void.

Initialisez une variable avec un tableau et appelez markReady($cart). Le & figure dans la déclaration, pas dans l’appel. Ne passez directement ni un littéral de tableau comme ['draft'], ni le résultat ordinaire d’une fonction qui renvoie par valeur ; un résultat renvoyé par référence peut être passé. Si la variable fournie ne contient pas un tableau, PHP lève une TypeError à l’entrée. Le type n’est pas revérifié à la sortie : une affectation via $items peut même changer le type d’une variable ordinaire de l’appelant.

Sans &, array $items est passé par valeur : remplacer un élément qui contient une simple chaîne, comme dans l’exemple, ne modifie pas le tableau de l’appelant. Ce n’est pas une copie profonde : les références déjà présentes dans le tableau peuvent continuer à partager des valeurs. Si la modification ne fait pas partie du contrat de la fonction, passez le tableau par valeur et renvoyez explicitement le résultat.

unset($items) supprime la liaison locale, pas la variable de l’appelant. En revanche, foreach ($items as &$item) crée une référence distincte vers un élément. Utilisez unset($item) après une telle boucle afin qu’une écriture ultérieure dans $item n’écrase pas le dernier élément parcouru.

Exemples

<?php
function markReadyCopy(array $items): void
{
    $items[0] = 'ready';
}

function markReady(array &$items): void
{
    $items[0] = 'ready';
}

$cart = ['draft'];
markReadyCopy($cart);
echo $cart[0], "\n";

markReady($cart);
echo $cart[0], "\n";

Résultat

draft
ready

Les deux fonctions écrivent `ready` à l’indice `0`. Après le passage par valeur, `$cart[0]` contient toujours `draft` ; après le passage par référence, il contient `ready`.

Leçons associées

  • PHP · Leçon 19 · Avancé · Version : 2

Sources