Array Multidimensi PHP: Array Bersarang dan Loop

Array multidimensi adalah array yang elemen-elemennya berupa array. Kamu membacanya dengan sepasang kurung siku untuk setiap level: $grid[1][2] adalah baris 1, kolom 2, dan $users[0]['name'] adalah nama di record pertama.

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

Bentuk kedua, list berisi record dengan field yang diberi nama, adalah yang paling sering kamu temui: bentuk inilah yang biasanya kamu dapat dari query database, response JSON yang sudah di-decode, atau file CSV yang sudah di-parse. Setiap record adalah sebuah array asosiatif.

Membuat array bersarang

Nesting bisa sedalam yang kamu butuhkan, dan setiap level boleh mencampur key numerik dan key string. Array konfigurasi adalah contoh yang umum: bagian-bagian yang diberi nama, masing-masing berisi pengaturan atau list.

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

Menambah baris dan nilai bersarang

$rows[] = [...] menambahkan satu baris utuh. $arr['key'][] = $value menambahkan ke dalam list bersarang, dan PHP membuat array di dalamnya pada kali pertama, jadi mengelompokkan nilai tidak butuh persiapan apa pun.

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

Perulangan atas array multidimensi

Pakai satu foreach per level. Untuk list berisi record, satu loop biasanya cukup karena kamu membaca field-nya berdasarkan nama. Untuk grid, loop dalam menelusuri sel-sel di setiap baris.

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

Membuat tabel HTML dari array

Array berisi baris langsung cocok dengan tabel HTML: key dari baris pertama menjadi header, dan setiap baris menjadi sebuah <tr>. Jalankan, maka tab Halaman menampilkan tabel yang sudah dirender; ubah sebuah nilai atau tambahkan baris lalu jalankan lagi.

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

Bentuk foreach (...): ... endforeach; adalah loop yang sama yang ditulis untuk template, jadi HTML-nya tetap mudah dibaca.

Mengambil satu kolom dari semua baris

array_column() mengambil satu field dari setiap baris ke dalam list yang datar. Berikan argumen ketiga untuk memakai field lain sebagai key hasilnya, yang mengubah list berisi record menjadi tabel lookup.

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

Mengurutkan baris berdasarkan field

usort() mengurutkan baris-baris dengan fungsi pembanding. Operator spaceship <=> mengembalikan -1, 0, atau 1, persis yang diharapkan usort(). Tukar $a dan $b untuk mengurutkan secara menurun.

<?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) menghitung 3 baris ditambah 6 field di dalamnya, itulah sebabnya hasilnya 9.

Kesalahan umum: membaca key dalam yang mungkin tidak ada

Membaca $config['cache']['ttl'] saat tidak ada key cache mencetak Warning: Undefined array key "cache", diikuti Warning: Trying to access array offset on null untuk level berikutnya. Operator ?? memeriksa seluruh rantai sekaligus dan tidak pernah memberi warning, jadi inilah cara yang aman untuk membaca nilai bersarang yang opsional.

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