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

CKTIS / PHP

Parcourir un tableau par référence avec `foreach`

Placez `&` devant la variable de valeur pour modifier directement les éléments du tableau. Après la boucle, utilisez `unset($p)` pour éviter de modifier le dernier élément parcouru par inadvertance.

Version : PHP 8.3

Syntaxe

foreach ($projects as &$p) {
    // Modify the current array element through $p.
}
unset($p);

En PHP 8.3, foreach ($projects as &$p) fait de $p un alias de l’élément courant du tableau à chaque itération. Cette syntaxe fait partie du langage PHP et ne nécessite aucune extension facultative. Affecter une valeur à $p remplace l’élément entier ; une affectation à $p['status'] modifie ce champ dans le tableau d’origine $projects. Pour obtenir aussi la clé, utilisez foreach ($projects as $key => &$p) : seule la valeur est liée par référence.

Si la boucle a parcouru au moins un élément, $p reste un alias du dernier élément parcouru, même après une sortie avec break. Exécutez unset($p) juste après la boucle pour rompre la liaison sans supprimer l’élément du tableau. L’affectation $p = null ne la rompt pas : elle écrit null dans cet élément.

Pour lire les données, utilisez foreach ($projects as $p) sans &. Pour le tableau d’enregistrements de l’exemple, affecter une valeur à $p, si cette variable n’est pas liée par référence, ou à $p['status'] dans un parcours par valeur ne modifie pas $projects. En revanche, sans unset($p), une boucle par valeur ultérieure qui réutilise $p peut écraser le dernier élément parcouru au fil de ses affectations.

Exemples

<?php
$projects = [
    ['name' => 'Atlas', 'status' => 'draft'],
    ['name' => 'Beacon', 'status' => 'review'],
];

foreach ($projects as &$p) {
    if ($p['status'] === 'draft') {
        $p['status'] = 'ready';
    }
}
unset($p);

foreach ($projects as $p) {
    echo $p['name'], ': ', $p['status'], "\n";
}

Résultat

Atlas: ready
Beacon: review

La première boucle fait passer le statut d’Atlas de `draft` à `ready`. Après `unset($p)`, la seconde réutilise `$p` sans risque pour afficher les deux projets ; Beacon conserve le statut `review`.

Leçons associées

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

Sources