Tablice wielowymiarowe w PHP: zagnieżdżanie i pętle

Tablica wielowymiarowa to tablica, której elementami są tablice. Odczytujesz ją jedną parą nawiasów na każdy poziom: $grid[1][2] to wiersz 1, kolumna 2, a $users[0]['name'] to imię w pierwszym rekordzie.

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

Drugi kształt, lista rekordów z nazwanymi polami, spotkasz najczęściej: zwykle daje go zapytanie do bazy danych, zdekodowana odpowiedź JSON albo przetworzony plik CSV. Każdy rekord jest tablicą asocjacyjną.

Tworzenie tablic zagnieżdżonych

Zagnieżdżenie może być tak głębokie, jak trzeba, a poziomy mogą łączyć klucze liczbowe i tekstowe. Częsty przykład to tablica konfiguracji: nazwane sekcje, z których każda zawiera ustawienia lub listy.

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

Dodawanie wierszy i zagnieżdżonych wartości

$rows[] = [...] dopisuje cały wiersz. $arr['key'][] = $value dopisuje do zagnieżdżonej listy, a PHP tworzy wewnętrzną tablicę przy pierwszym użyciu, więc grupowanie wartości nie wymaga przygotowań.

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

Przechodzenie po tablicy wielowymiarowej

Użyj jednego foreach na każdy poziom. Dla listy rekordów zwykle wystarczy jedna pętla, bo pola odczytujesz po nazwie. Dla siatki pętla wewnętrzna przechodzi po komórkach każdego wiersza.

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

Budowanie tabeli HTML z tablicy

Tablica wierszy przekłada się bezpośrednio na tabelę HTML: klucze pierwszego wiersza stają się nagłówkiem, a każdy wiersz staje się <tr>. Uruchom, a zakładka Page pokaże wyrenderowaną tabelę; zmień wartość albo dodaj wiersz i uruchom ponownie.

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

Forma foreach (...): ... endforeach; to ta sama pętla zapisana dla szablonów, dzięki czemu HTML pozostaje czytelny.

Jedna kolumna ze wszystkich wierszy

array_column() wyciąga jedno pole z każdego wiersza do płaskiej listy. Podaj trzeci argument, aby kluczami wyniku było inne pole: tak lista rekordów zamienia się w tablicę do wyszukiwania.

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

Sortowanie wierszy po polu

usort() sortuje wiersze funkcją porównującą. Operator statku kosmicznego <=> zwraca -1, 0 albo 1, czyli dokładnie to, czego oczekuje usort(). Zamień $a i $b, aby sortować malejąco.

<?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) liczy 3 wiersze plus 6 pól w ich wnętrzu, dlatego wypisuje 9.

Częsty błąd: odczyt głębokiego klucza, którego może brakować

Odczyt $config['cache']['ttl'], gdy nie ma klucza cache, wypisuje Warning: Undefined array key "cache", a dla kolejnego poziomu Warning: Trying to access array offset on null. Operator ?? sprawdza cały łańcuch naraz i nigdy nie ostrzega, więc to bezpieczny sposób odczytu opcjonalnych zagnieżdżonych wartości.

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