Tableaux multidimensionnels PHP : imbrication et boucles

Un tableau multidimensionnel est un tableau dont les éléments sont des tableaux. Vous le lisez avec une paire de crochets par niveau : $grid[1][2] est la ligne 1, colonne 2, et $users[0]['name'] est le nom du premier enregistrement.

<?php
$grid = [
    [1, 2, 3],
    [4, 5, 6],
    [7, 8, 9],
];

echo $grid[1][2], "\n";   // row 1, column 2

$users = [
    ['name' => 'Ada',   'role' => 'admin'],
    ['name' => 'Linus', 'role' => 'editor'],
];

echo $users[0]['name'], "\n";
echo $users[1]['role'], "\n";

$grid[2][0] = 70;         // change a nested value
echo implode(' ', $grid[2]), "\n";

La seconde forme, une liste d'enregistrements aux champs nommés, est celle que vous rencontrerez le plus : c'est ce que vous donnent en général une requête en base de données, une réponse JSON décodée ou un fichier CSV analysé. Chaque enregistrement est un tableau associatif.

Créer des tableaux imbriqués

L'imbrication peut aller aussi loin que nécessaire, et les niveaux peuvent mélanger clés numériques et clés de type chaîne. Un tableau de configuration en est un exemple courant : des sections nommées, chacune contenant des réglages ou des listes.

<?php
$config = [
    'db' => [
        'host' => 'localhost',
        'port' => 3306,
    ],
    'admins' => ['ada', 'grace'],
    'features' => [
        'search' => ['enabled' => true, 'limit' => 20],
    ],
];

echo $config['db']['host'], "\n";
echo $config['admins'][1], "\n";
echo $config['features']['search']['limit'], "\n";

Ajouter des lignes et des valeurs imbriquées

$rows[] = [...] ajoute une ligne entière. $arr['key'][] = $value ajoute dans une liste imbriquée, et PHP crée le tableau intérieur la première fois, donc regrouper des valeurs ne demande aucune préparation.

<?php
$orders = [
    ['customer' => 'Ada',   'item' => 'book'],
    ['customer' => 'Linus', 'item' => 'pen'],
    ['customer' => 'Ada',   'item' => 'lamp'],
];

$orders[] = ['customer' => 'Grace', 'item' => 'mug'];   // add a row

$byCustomer = [];
foreach ($orders as $order) {
    $byCustomer[$order['customer']][] = $order['item'];  // inner array created on first use
}

print_r($byCustomer);

Parcourir un tableau multidimensionnel

Utilisez un foreach par niveau. Pour une liste d'enregistrements, une boucle suffit en général car vous lisez les champs par leur nom. Pour une grille, la boucle intérieure parcourt les cellules de chaque ligne.

<?php
$students = [
    ['name' => 'Ada',   'scores' => [90, 85, 99]],
    ['name' => 'Linus', 'scores' => [70, 88, 79]],
];

foreach ($students as $student) {
    $average = array_sum($student['scores']) / count($student['scores']);
    echo $student['name'], ": ", round($average, 1), "\n";
}

$grid = [[1, 2, 3], [4, 5, 6]];
foreach ($grid as $r => $row) {
    foreach ($row as $c => $cell) {
        echo "[$r][$c]=$cell ";
    }
    echo "\n";
}

Construire un tableau HTML à partir d'un tableau

Un tableau de lignes correspond directement à un tableau HTML : les clés de la première ligne deviennent l'en-tête, et chaque ligne devient un <tr>. Exécutez-le et l'onglet Page affiche le tableau rendu ; modifiez une valeur ou ajoutez une ligne et relancez.

<?php
$products = [
    ['name' => 'Keyboard', 'price' => 49.99, 'stock' => 12],
    ['name' => 'Mouse',    'price' => 19.50, 'stock' => 0],
    ['name' => 'Monitor',  'price' => 189.00, 'stock' => 4],
];
?>
<style>
  table { border-collapse: collapse; font-family: sans-serif; }
  th, td { border: 1px solid #ccc; padding: 6px 12px; text-align: left; }
  .out { color: #b00; }
</style>
<table>
  <tr>
    <?php foreach (array_keys($products[0]) as $heading): ?>
      <th><?= htmlspecialchars(ucfirst($heading)) ?></th>
    <?php endforeach; ?>
  </tr>
  <?php foreach ($products as $product): ?>
    <tr class="<?= $product['stock'] === 0 ? 'out' : '' ?>">
      <td><?= htmlspecialchars($product['name']) ?></td>
      <td><?= number_format($product['price'], 2) ?></td>
      <td><?= $product['stock'] ?></td>
    </tr>
  <?php endforeach; ?>
</table>

La forme foreach (...): ... endforeach; est la même boucle écrite pour les templates, ce qui garde le HTML lisible.

Extraire une colonne de toutes les lignes

array_column() extrait un champ de chaque ligne dans une liste à plat. Passez un troisième argument pour indexer le résultat par un autre champ, ce qui transforme une liste d'enregistrements en table de correspondance.

<?php
$users = [
    ['id' => 3, 'name' => 'Ada',   'email' => 'ada@example.com'],
    ['id' => 7, 'name' => 'Linus', 'email' => 'linus@example.com'],
    ['id' => 9, 'name' => 'Grace', 'email' => 'grace@example.com'],
];

print_r(array_column($users, 'name'));
print_r(array_column($users, 'email', 'id'));   // id => email

$byId = array_column($users, null, 'id');       // id => whole row
echo $byId[7]['name'], "\n";

Trier des lignes par un champ

usort() trie les lignes avec une fonction de comparaison. L'opérateur spaceship <=> renvoie -1, 0 ou 1, exactement ce qu'attend usort(). Échangez $a et $b pour trier dans l'ordre décroissant.

<?php
$players = [
    ['name' => 'Ada',   'points' => 120],
    ['name' => 'Linus', 'points' => 95],
    ['name' => 'Grace', 'points' => 140],
];

usort($players, fn($a, $b) => $b['points'] <=> $a['points']);   // highest first

foreach ($players as $rank => $player) {
    echo $rank + 1, ". {$player['name']} ({$player['points']})\n";
}

echo count($players), " rows, ", count($players, COUNT_RECURSIVE), " elements in total\n";

count($players, COUNT_RECURSIVE) compte les 3 lignes plus les 6 champs qu'elles contiennent, c'est pourquoi il affiche 9.

Erreur fréquente : lire une clé profonde qui manque peut-être

Lire $config['cache']['ttl'] quand il n'y a pas de clé cache affiche Warning: Undefined array key "cache", suivi de Warning: Trying to access array offset on null pour le niveau suivant. L'opérateur ?? vérifie toute la chaîne d'un coup et n'affiche jamais de warning, c'est donc la façon sûre de lire des valeurs imbriquées facultatives.

<?php
$config = ['db' => ['host' => 'localhost']];

$ttl  = $config['cache']['ttl'] ?? 60;          // missing at the first level
$port = $config['db']['port'] ?? 3306;          // missing at the second level
$host = $config['db']['host'] ?? '127.0.0.1';   // present

echo "$ttl $port $host\n";
var_dump(isset($config['db']['host']));