En PHP, list permet d’extraire plusieurs valeurs d’un tableau et de les affecter directement à des variables. Cette syntaxe rend le code plus lisible lorsqu’une fonction renvoie plusieurs résultats ou qu’un tableau contient des données bien ordonnées — à condition de comprendre comment les indices déterminent chaque affectation.
L’article en bref
La déstructuration avec list transforme les cases d’un tableau en variables prêtes à l’emploi. Quelques règles sur les indices et les clés évitent les surprises.
- Principe : Affecter les valeurs d’un tableau à plusieurs variables en une seule instruction.
- Indices : Respecter l’ordre numérique ou cibler les clés associatives explicitement.
- Usages : Extraire des résultats de fonctions et des données imbriquées clairement.
- Précautions : Vérifier les clés présentes et la version de PHP utilisée.
À retenir : bien maîtrisée, cette syntaxe simplifie l’extraction sans masquer la structure des données.
Comment fonctionne list en PHP pour déstructurer un tableau
Imaginez Lina, qui prépare un catalogue de films et reçoit pour chaque titre un tableau contenant le nom, l’année et la durée. Au lieu d’accéder à chaque indice séparément, elle peut utiliser list pour répartir les valeurs entre plusieurs variables en une seule affectation.
La forme classique est list($titre, $annee, $duree) = $film;. Les variables reçoivent les valeurs correspondant aux indices numériques 0, 1 et 2, dans cet ordre : la syntaxe suit la structure du tableau, comme une fiche de casting où chaque rôle a sa place.
Déstructurer un tableau indexé avec list
Pour un tableau indexé, l’ordre est déterminant. Si $film contient « Solaris », 1972 et 167 aux indices 0, 1 et 2, l’instruction précédente affecte ces valeurs à $titre, $annee et $duree.
La déstructuration ne trie pas et ne devine rien : elle lit les emplacements prévus. Si une case manque, la variable correspondante ne reçoit pas la valeur attendue, ce qui peut produire un avertissement selon le contexte et la version de PHP. Vérifier le tableau avant l’affectation reste donc un réflexe utile.
Utiliser les indices et les clés associatives avec list en PHP
Les tableaux associatifs donnent un nom aux données, ce qui les rend plus explicites qu’une suite de nombres. Depuis PHP 7.1, la déstructuration peut viser une clé précise : Lina peut ainsi extraire le titre et l’année même si le tableau contient d’autres champs ou si leur ordre change.
La syntaxe s’écrit par exemple [‘titre’ => $titre, ‘annee’ => $annee] = $film;. Cette forme associe chaque variable à la clé correspondante, plutôt qu’à sa position. Elle convient particulièrement aux données issues d’API ou de configurations, dont l’ordre des éléments ne devrait pas dicter la logique du programme.
Choisir entre positions numériques et clés nommées
Les indices numériques sont pratiques lorsque le format est stable et compact, par exemple le résultat d’une fonction qui renvoie toujours trois valeurs dans le même ordre. Les clés nommées sont plus robustes quand les données peuvent évoluer : elles indiquent clairement ce que chaque variable reçoit.
Pour ignorer une valeur dans un tableau indexé, il est possible de laisser un emplacement vide dans list($titre, , $duree) = $film;. Cette possibilité évite de créer une variable inutile, mais ne change pas la position des éléments suivants : la durée reste associée au troisième indice.
| Forme de déstructuration | Correspondance | Usage adapté |
|---|---|---|
| list($a, $b) | Indices numériques 0 et 1 | Tableau ordonné au format stable |
| [$a, , $c] | Indices 0 et 2, valeur centrale ignorée | Extraction de quelques positions utiles |
| [‘titre’ => $titre] | Clé associative « titre » | Données nommées, notamment depuis PHP 7.1 |
Déstructuration imbriquée et bonnes pratiques de programmation
Un tableau peut lui-même contenir d’autres tableaux. Lina reçoit, par exemple, une entrée où les informations du film sont regroupées dans une sous-structure : une déstructuration imbriquée permet de récupérer plusieurs valeurs sans multiplier les accès successifs. Cette approche fonctionne bien lorsque la forme des données reste clairement définie.
On peut aussi utiliser list pour récupérer plusieurs résultats renvoyés par une fonction. Dans ce cas, le choix des variables rend l’appel plus parlant, mais il faut documenter l’ordre des valeurs si les noms des éléments ne sont pas visibles dans la structure elle-même.
Les réflexes qui rendent la syntaxe fiable
La déstructuration est concise, mais une ligne compacte peut cacher une hypothèse importante : la position ou la clé attendue existe bien. Avant de l’utiliser, Lina vérifie donc la forme des données reçues, surtout lorsqu’elles viennent d’une source externe ou peuvent être incomplètes.
- Vérifier les indices ou les clés avant l’affectation lorsque le tableau est incertain.
- Préférer les clés nommées si l’ordre des données risque de changer.
- Éviter les lignes trop chargées : quelques affectations simples valent mieux qu’une déstructuration difficile à relire.
- Contrôler la version de PHP, car la déstructuration par clés associatives nécessite PHP 7.1 ou une version ultérieure.
Le bon critère n’est pas d’écrire le moins de caractères possible, mais de rendre l’extraction évidente pour la personne qui relira le code. Une syntaxe concise est utile tant qu’elle expose clairement la structure qu’elle exploite.
Questions fréquentes sur list et la déstructuration en PHP
Quelle différence entre list() et la déstructuration avec des crochets ?
Les deux syntaxes servent à affecter des valeurs d’un tableau à des variables. Depuis PHP 7.1, les crochets offrent une écriture plus moderne et prennent aussi en charge la sélection par clés associatives.
Peut-on ignorer une valeur avec list en PHP ?
Oui. Dans un tableau indexé, laissez une position vide, par exemple list($titre, , $duree). Les valeurs suivantes conservent leur position d’origine.
list fonctionne-t-il avec les tableaux associatifs ?
Oui, avec une syntaxe par clés comme [‘titre’ => $titre] = $film;, disponible à partir de PHP 7.1. Cela permet de ne pas dépendre de l’ordre des éléments.
Que se passe-t-il si une clé attendue est absente ?
La variable correspondante ne reçoit pas la valeur prévue et PHP peut signaler une clé ou un indice manquant. Il est préférable de vérifier la structure des données avant l’affectation.
