PHP mehrdimensionale Arrays: verschachtelt und Schleifen

Ein mehrdimensionales Array ist ein Array, dessen Elemente Arrays sind. Du liest es mit einem Klammerpaar pro Ebene: $grid[1][2] ist Zeile 1, Spalte 2, und $users[0]['name'] ist der Name im ersten Datensatz.

<?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";

Die zweite Form, eine Liste von Datensätzen mit benannten Feldern, begegnet dir am häufigsten: Das liefert dir meist eine Datenbankabfrage, eine dekodierte JSON-Antwort oder eine eingelesene CSV-Datei. Jeder Datensatz ist ein assoziatives Array.

Verschachtelte Arrays erstellen

Die Verschachtelung kann so tief gehen, wie du brauchst, und die Ebenen können numerische und String-Schlüssel mischen. Ein Konfigurations-Array ist ein typisches Beispiel: benannte Abschnitte, die jeweils Einstellungen oder Listen enthalten.

<?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";

Zeilen und verschachtelte Werte hinzufügen

$rows[] = [...] hängt eine ganze Zeile an. $arr['key'][] = $value hängt in einer verschachtelten Liste an, und PHP erzeugt das innere Array beim ersten Mal, also braucht das Gruppieren von Werten keine Vorbereitung.

<?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);

Ein mehrdimensionales Array durchlaufen

Verwende ein foreach pro Ebene. Bei einer Liste von Datensätzen reicht meist eine Schleife, weil du die Felder über ihren Namen liest. Bei einem Raster läuft die innere Schleife über die Zellen jeder Zeile.

<?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";
}

Eine HTML-Tabelle aus einem Array bauen

Ein Array von Zeilen passt direkt auf eine HTML-Tabelle: Die Schlüssel der ersten Zeile werden zur Kopfzeile, und jede Zeile wird zu einem <tr>. Führe es aus, und der Tab Page zeigt die gerenderte Tabelle; ändere einen Wert oder füge eine Zeile hinzu und führe es erneut aus.

<?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>

Die Form foreach (...): ... endforeach; ist dieselbe Schleife, für Templates geschrieben, damit das HTML lesbar bleibt.

Eine Spalte aus allen Zeilen holen

array_column() zieht ein Feld aus jeder Zeile in eine flache Liste. Übergib ein drittes Argument, um das Ergebnis nach einem anderen Feld zu schlüsseln, und aus einer Liste von Datensätzen wird eine Nachschlagetabelle.

<?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";

Zeilen nach einem Feld sortieren

usort() sortiert die Zeilen mit einer Vergleichsfunktion. Der Spaceship-Operator <=> liefert -1, 0 oder 1, genau das, was usort() erwartet. Vertausche $a und $b, um absteigend zu sortieren.

<?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) zählt die 3 Zeilen plus die 6 Felder darin, deshalb gibt es 9 aus.

Typischer Fehler: einen tiefen Schlüssel lesen, der fehlen könnte

$config['cache']['ttl'] zu lesen, wenn es keinen Schlüssel cache gibt, gibt Warning: Undefined array key "cache" aus, gefolgt von Warning: Trying to access array offset on null für die nächste Ebene. Der Operator ?? prüft die ganze Kette auf einmal und warnt nie, ist also der sichere Weg, optionale verschachtelte Werte zu lesen.

<?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']));