foreach PHP: Key Value, Indeks, dan Referensi

foreach ($array as $value) menjalankan blok sekali untuk setiap elemen, dengan $value berisi elemen yang sedang diproses. Untuk mendapatkan key-nya juga, tulis foreach ($array as $key => $value).

<?php
$colors = ['red', 'green', 'blue'];

foreach ($colors as $color) {
    echo $color, "\n";
}

$ages = ['Ada' => 36, 'Linus' => 28, 'Grace' => 45];

foreach ($ages as $name => $age) {
    echo "$name is $age\n";
}

foreach bekerja pada array apa pun, apa pun key-nya, dan kamu tidak perlu mengurus counter atau memeriksa panjang array. Inilah loop yang paling sering kamu tulis di PHP.

Perulangan atas key dan value

Di $key => $value, nama variabelnya bebas kamu pilih: $name => $age, $id => $user, $k => $v. Pada list, key-nya adalah posisi 0, 1, 2. Pada array asosiatif, key-nya adalah key string yang kamu tentukan.

<?php
$config = [
    'host' => 'localhost',
    'port' => 8080,
    'debug' => true,
];

foreach ($config as $key => $value) {
    printf("%-6s = %s\n", $key, var_export($value, true));
}

// Only the keys
foreach (array_keys($config) as $key) {
    echo "key: $key\n";
}

// Keys like "1" become integers
$codes = ["1" => 'one', "01" => 'zero one'];
foreach ($codes as $key => $value) {
    echo gettype($key), " key ", var_export($key, true), " => $value\n";
}

Loop terakhir menunjukkan detail yang sering mengejutkan: key string yang terlihat seperti bilangan bulat, misalnya "1", disimpan sebagai integer 1. "01" bukan bentuk integer yang kanonis, jadi tetap menjadi string.

Mendapatkan indeks di foreach

Pada list, key-nya adalah indeks, jadi foreach ($items as $i => $item) sudah cukup. Pada array asosiatif tidak ada posisi berupa angka, jadi buat counter sendiri. Untuk memperlakukan elemen pertama atau terakhir secara berbeda, bandingkan key dengan array_key_first() atau array_key_last().

<?php
$steps = ['Preheat', 'Mix', 'Bake'];

foreach ($steps as $i => $step) {
    echo "Step ", $i + 1, ": $step\n";   // index starts at 0
}

$scores = ['Ada' => 91, 'Linus' => 78, 'Grace' => 85];
$position = 1;
foreach ($scores as $name => $score) {
    echo "#$position $name ($score)\n";
    $position++;
}

$last = array_key_last($scores);
foreach ($scores as $name => $score) {
    echo $name, $name === $last ? "\n" : ", ";
}

Loop terakhir mencetak koma di antara nama, tetapi tidak setelah nama terakhir. Untuk tugas persis seperti itu, implode(', ', array_keys($scores)) lebih singkat; pemeriksaan array_key_last() gunanya saat putaran terakhir butuh logika yang berbeda, bukan sekadar pemisah yang berbeda.

Mengubah nilai array di foreach (lewat referensi)

$value adalah salinan. Memberi nilai baru padanya tidak mengubah apa pun di array. Untuk mengubah array, lakukan perulangan lewat referensi dengan &$value, atau tulis kembali lewat key.

<?php
$prices = [10, 25, 40];

foreach ($prices as $price) {
    $price = $price * 2;          // changes the copy only
}
echo implode(', ', $prices), "\n";

foreach ($prices as &$price) {
    $price = $price * 2;          // changes the array
}
unset($price);                    // break the reference (see next section)
echo implode(', ', $prices), "\n";

foreach ($prices as $key => $price) {
    $prices[$key] = $price + 1;   // same effect, no reference
}
echo implode(', ', $prices), "\n";

Keduanya berfungsi. Versi dengan key tidak meninggalkan state tersembunyi setelah loop selesai, itulah sebabnya banyak tim lebih menyukainya. Untuk membuat array baru alih-alih mengubah yang lama, array_map() adalah pilihan lain.

Pertanyaan yang berkaitan: apa yang terjadi jika kamu menambah elemen selama perulangan? foreach biasa menelusuri array seperti saat loop dimulai, jadi $prices[] = ... di dalamnya tidak menambah putaran. Loop lewat referensi menelusuri array yang hidup dan ikut mengunjungi elemen baru.

Jebakan unset() pada foreach lewat referensi

Setelah foreach ($arr as &$v), variabel $v masih menjadi referensi ke elemen terakhir array. Jika nanti kamu memakai lagi nama $v di loop biasa, setiap putaran menulis ke elemen terakhir itu. Jalankan kode ini dan lihat item terakhirnya:

<?php
$letters = ['a', 'b', 'c'];

foreach ($letters as &$v) {
    $v = strtoupper($v);
}
// missing: unset($v);

foreach ($letters as $v) {
    // each pass assigns to $v, which is still $letters[2]
}

print_r($letters);   // C was overwritten

$fixed = ['a', 'b', 'c'];
foreach ($fixed as &$v) {
    $v = strtoupper($v);
}
unset($v);           // the fix
foreach ($fixed as $v) {
}
print_r($fixed);

Loop kedua memberi nilai A, lalu B, lalu nilai milik elemen terakhir itu sendiri ke $letters[2], dan pada putaran terakhir slot itu sudah berisi B. Perbaikannya cuma satu baris: tulis unset($v); tepat setelah setiap foreach lewat referensi.

break dan continue di foreach

break keluar dari loop, continue melompat ke elemen berikutnya. Pola yang umum adalah pencarian: lakukan perulangan sampai kamu menemukan yang dicari, lalu break agar sisa array tidak diperiksa.

<?php
$orders = [
    ['id' => 101, 'status' => 'paid'],
    ['id' => 102, 'status' => 'cancelled'],
    ['id' => 103, 'status' => 'paid'],
    ['id' => 104, 'status' => 'pending'],
];

foreach ($orders as $order) {
    if ($order['status'] === 'cancelled') {
        continue;               // skip this one
    }
    echo "Order {$order['id']}: {$order['status']}\n";
}

$found = null;
foreach ($orders as $order) {
    if ($order['status'] === 'pending') {
        $found = $order;
        break;                  // stop searching
    }
}
echo "First pending: ", $found['id'] ?? 'none', "\n";

Di loop bersarang, break 2 keluar dari loop dalam dan loop yang membungkusnya, dan continue 2 melompat ke putaran berikutnya dari loop luar.

Array bersarang dan foreach dengan list()

Baris-baris data adalah array di dalam array. Lakukan perulangan atas barisnya, lalu atas setiap baris, atau ambil field-nya langsung di baris foreach dengan array destructuring: [$a, $b] untuk list, ['key' => $var] untuk baris asosiatif. list($a, $b) adalah cara penulisan lama untuk [$a, $b].

<?php
$users = [
    ['name' => 'Ada', 'langs' => ['PHP', 'Python']],
    ['name' => 'Linus', 'langs' => ['C']],
];

// Nested foreach
foreach ($users as $user) {
    echo $user['name'], ":";
    foreach ($user['langs'] as $lang) {
        echo " $lang";
    }
    echo "\n";
}

// Destructuring associative rows
foreach ($users as ['name' => $name, 'langs' => $langs]) {
    echo "$name knows ", count($langs), " language(s)\n";
}

// Destructuring list rows (list() is the same as [])
$points = [[1, 2], [3, 5], [8, 13]];
foreach ($points as [$x, $y]) {
    echo "($x, $y) ";
}
echo "\n";
foreach ($points as list($x, $y)) {
    echo $x + $y, " ";
}

Halaman destructuring membahas lebih banyak tentang sintaks [...] =, termasuk elemen yang dilewati dan pola bersarang.

Membuat list atau tabel HTML dengan foreach

Di template, bentuk titik dua foreach (...): dengan endforeach; membuat loop tetap mudah dibaca di antara tag. Blok ini membuat tabel, dan judul kolomnya berupa link: klik salah satunya di tab Halaman, maka script yang sama berjalan lagi dengan $_GET['sort'] terisi, sehingga baris-barisnya muncul dengan urutan baru.

<?php
$products = [
    ['name' => 'Keyboard', 'price' => 49.0, 'stock' => 12],
    ['name' => 'Mouse', 'price' => 19.5, 'stock' => 40],
    ['name' => 'Monitor', 'price' => 189.0, 'stock' => 3],
    ['name' => 'Cable', 'price' => 6.25, 'stock' => 0],
];

$sort = $_GET['sort'] ?? 'name';
if (!in_array($sort, ['name', 'price', 'stock'], true)) {
    $sort = 'name';
}
usort($products, fn($a, $b) => $a[$sort] <=> $b[$sort]);

$total = 0;
foreach ($products as $p) {
    $total += $p['price'] * $p['stock'];
}
?>
<style>
    table { border-collapse: collapse; font-family: sans-serif; }
    th, td { border: 1px solid #ccc; padding: 4px 10px; }
    .out { color: #999; }
</style>
<table>
    <tr>
        <?php foreach (['name', 'price', 'stock'] as $col): ?>
            <th><a href="?sort=<?= $col ?>"><?= ucfirst($col) ?></a><?= $col === $sort ? ' ▲' : '' ?></th>
        <?php endforeach; ?>
    </tr>
    <?php foreach ($products as $p): ?>
        <tr class="<?= $p['stock'] === 0 ? 'out' : '' ?>">
            <td><?= htmlspecialchars($p['name']) ?></td>
            <td><?= number_format($p['price'], 2) ?></td>
            <td><?= $p['stock'] ?></td>
        </tr>
    <?php endforeach; ?>
</table>
<p>Stock value: <?= number_format($total, 2) ?></p>

Dua kebiasaan yang layak ditiru dari blok ini: nilai sort dari URL diperiksa terhadap daftar kolom yang diizinkan sebelum dipakai, dan setiap nilai yang dicetak ke HTML dan bisa berisi teks dari pengguna melewati htmlspecialchars().

foreach atas null, array kosong, atau object

Array kosong tidak masalah: body-nya tidak pernah dijalankan. null, string, atau angka bermasalah: PHP mencetak warning dan melewati loop. Untuk $tags = null; foreach ($tags as $tag), outputnya:

Warning: foreach() argument must be of type array|object, null given in /var/www/html/index.php on line 4

Ini paling sering terjadi pada data yang kadang tidak ada, seperti field opsional di JSON yang sudah di-decode. Gunakan array kosong sebagai cadangan dengan ??:

foreach ($data['tags'] ?? [] as $tag) {
    echo $tag;
}

Kata object dalam pesan itu memang benar: foreach atas object mengunjungi property yang terlihat dari tempat loop dijalankan (di luar class, berarti yang public), dengan nama property sebagai key. Class yang mengimplementasikan Iterator atau IteratorAggregate, serta generator, menentukan sendiri apa yang dilihat oleh foreach.

foreach vs for vs array_map

Cara cepat untuk memutuskan: jika body loop hanya menghitung nilai baru untuk setiap elemen, array_map(fn($x) => $x * 2, $a) mengatakannya dalam satu baris. Jika ada efek samping (mencetak, menyimpan, menghitung beberapa hal sekaligus) atau butuh break, tulis foreach.