Многомерные массивы PHP: вложенные массивы и циклы

Многомерный массив это массив, элементы которого тоже массивы. Читается он по одной паре скобок на уровень: $grid[1][2] это строка 1, столбец 2, а $users[0]['name'] это имя в первой записи.

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

Вторая форма, список записей с именованными полями, встречается чаще всего: именно её обычно дают запрос к базе данных, декодированный JSON-ответ или разобранный CSV-файл. Каждая запись это ассоциативный массив.

Создание вложенных массивов

Вложенность может быть любой глубины, а уровни могут сочетать числовые и строковые ключи. Частый пример это массив настроек: именованные разделы, в каждом из которых настройки или списки.

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

Добавление строк и вложенных значений

$rows[] = [...] добавляет целую строку. $arr['key'][] = $value добавляет во вложенный список, а внутренний массив PHP создаёт при первом обращении, так что группировка значений не требует подготовки.

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

Обход многомерного массива

Используйте по одному foreach на уровень. Для списка записей обычно хватает одного цикла, потому что поля читаются по имени. Для сетки внутренний цикл проходит ячейки каждой строки.

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

HTML-таблица из массива

Массив строк напрямую ложится на HTML-таблицу: ключи первой строки становятся заголовком, а каждая строка становится <tr>. Запустите, и вкладка Page покажет готовую таблицу; измените значение или добавьте строку и запустите снова.

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

Форма foreach (...): ... endforeach; это тот же цикл, записанный для шаблонов, чтобы HTML оставался читаемым.

Один столбец из всех строк

array_column() извлекает одно поле из каждой строки в плоский список. Передайте третий аргумент, чтобы сделать ключами результата другое поле, и список записей превратится в таблицу поиска.

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

Сортировка строк по полю

usort() сортирует строки функцией сравнения. Оператор spaceship <=> возвращает -1, 0 или 1, ровно то, чего ждёт usort(). Поменяйте $a и $b местами, чтобы сортировать по убыванию.

<?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) считает 3 строки и 6 полей внутри них, поэтому выводит 9.

Частая ошибка: чтение глубокого ключа, которого может не быть

Чтение $config['cache']['ttl'] при отсутствии ключа cache печатает Warning: Undefined array key "cache", а следом Warning: Trying to access array offset on null для следующего уровня. Оператор ?? проверяет всю цепочку сразу и никогда не предупреждает, поэтому это безопасный способ читать необязательные вложенные значения.

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