Tableaux PHP : créer, lire, parcourir et afficher

Un tableau PHP stocke une liste de valeurs sous des clés. Créez-en un avec des crochets, $fruits = ['apple', 'banana', 'cherry'];, et lisez un élément par son index, $fruits[0]. Les index commencent à 0, et count($fruits) donne le nombre d'éléments.

<?php
$fruits = ['apple', 'banana', 'cherry'];

echo $fruits[0], "\n";        // first element
echo $fruits[2], "\n";        // third element
echo count($fruits), "\n";    // number of elements

$fruits[] = 'date';           // add to the end
$fruits[1] = 'blueberry';     // change an element

print_r($fruits);

Chaque tableau PHP est une map ordonnée : chaque valeur est rangée sous une clé. Quand vous ne choisissez pas les clés, PHP les numérote 0, 1, 2... et vous obtenez un tableau indexé. Quand vous les choisissez vous-même (['name' => 'Ada']), vous obtenez un tableau associatif. Les deux sont le même type array.

Créer un tableau

Les crochets sont la syntaxe habituelle. array() est l'ancienne écriture et produit exactement la même chose. range() construit une liste de nombres ou de lettres, et array_fill() répète une valeur.

<?php
$empty   = [];
$numbers = [10, 20, 30];
$old     = array('a', 'b', 'c');      // same as ['a', 'b', 'c']
$mixed   = [1, 'two', 3.5, true, null];

$oneToFive = range(1, 5);
$letters   = range('a', 'e');
$zeros     = array_fill(0, 3, 0);

echo implode(', ', $oneToFive), "\n";
echo implode(', ', $letters), "\n";
echo implode(', ', $zeros), "\n";
var_dump($empty === []);
echo count($mixed), "\n";

Un tableau PHP peut contenir à la fois des valeurs de types différents, y compris d'autres tableaux. Un tableau de tableaux est un tableau multidimensionnel, la façon habituelle de stocker des lignes de données.

Obtenir le premier et le dernier élément

PHP n'a pas d'index négatifs. $arr[-1] ne signifie pas « le dernier » : il cherche une clé nommée -1 et, quand il n'y en a pas, PHP affiche Warning: Undefined array key -1. Utilisez array_key_first() et array_key_last(), qui fonctionnent aussi quand les clés ne commencent pas à 0.

<?php
$queue = ['Ada', 'Grace', 'Linus', 'Margaret'];

$first = $queue[array_key_first($queue)];
$last  = $queue[array_key_last($queue)];
echo "First: $first, last: $last\n";

// Same result by position
echo $queue[count($queue) - 1], "\n";

// The last two elements
print_r(array_slice($queue, -2));

end($queue) renvoie aussi la dernière valeur, mais déplace le pointeur interne du tableau au passage, la version par clé est donc plus claire.

Afficher un tableau

echo $arr ne fonctionne pas : il affiche le mot Array et un warning. Choisissez l'affichage adapté au besoin :

• print_r($arr) pour un affichage lisible pendant le débogage.
• var_dump($arr) pour voir aussi le type et la longueur de chaque valeur.
• implode(', ', $arr) pour transformer les valeurs en une seule chaîne à afficher.
• json_encode($arr) pour envoyer le tableau à JavaScript ou à une API.

<?php
$scores = [90, 72, 85];

print_r($scores);
var_dump($scores);
echo implode(', ', $scores), "\n";
echo json_encode($scores), "\n";

La page print_r et var_dump couvre les options de formatage, y compris l'affichage d'un tableau dans du HTML.

Parcourir un tableau

foreach est la boucle faite pour les tableaux : elle vous donne chaque valeur, et la clé si vous la demandez. Une boucle for avec un index fonctionne aussi pour les tableaux indexés dont les clés partent de 0 sans trou.

<?php
$languages = ['PHP', 'Python', 'Go'];

foreach ($languages as $language) {
    echo "I know $language\n";
}

foreach ($languages as $i => $language) {
    echo ($i + 1) . ". $language\n";
}

for ($i = 0; $i < count($languages); $i++) {
    echo strtolower($languages[$i]), "\n";
}

Les tableaux sont copiés, pas partagés

Affecter un tableau à une autre variable, ou le passer à une fonction, donne une copie. Modifier la copie laisse l'original intact. Ajoutez & au paramètre quand une fonction doit modifier le tableau de l'appelant.

<?php
$a = [1, 2, 3];
$b = $a;          // a copy
$b[] = 4;

echo count($a), " ", count($b), "\n";

function addItem(array &$list, string $item): void
{
    $list[] = $item;
}

$cart = ['milk'];
addItem($cart, 'bread');
print_r($cart);

Les fonctions de tableau par tâche

PHP fournit plus de 70 fonctions de tableau. Voici celles que vous utiliserez le plus, chacune avec sa page :

Des clés qui fusionnent sans prévenir

Les clés de tableau sont des entiers ou des chaînes, et PHP convertit certaines clés pour vous. Une chaîne qui ressemble à un entier décimal, comme "1", devient l'entier 1, donc $a["1"] et $a[1] désignent le même emplacement. "01" et "1.5" restent des chaînes. C'est pourquoi un tableau construit à partir d'une saisie de formulaire ou d'un CSV peut finir avec moins d'éléments que prévu.

<?php
$a = [];
$a[1]    = 'int one';
$a["1"]  = 'string one';   // same key as 1, overwrites it
$a["01"] = 'zero one';     // stays the string "01"

var_dump($a);
echo count($a), "\n";