Vòng lặp foreach trong PHP: key value, chỉ số và tham chiếu

foreach ($array as $value) chạy khối lệnh một lần cho mỗi phần tử, với $value là phần tử hiện tại. Để lấy cả khóa, hãy viết 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 chạy được với mọi mảng, bất kể khóa là gì, và bạn không bao giờ phải tự quản lý biến đếm hay kiểm tra độ dài. Đây là vòng lặp (loop) bạn sẽ viết nhiều nhất trong PHP.

Lặp qua khóa và giá trị

Trong $key => $value, bạn tự chọn tên: $name => $age, $id => $user, $k => $v. Với một danh sách, khóa là các vị trí 0, 1, 2. Với mảng kết hợp (associative array), khóa là các chuỗi do bạn định nghĩa.

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

Vòng lặp cuối cho thấy một chi tiết khiến nhiều người bất ngờ: khóa dạng chuỗi trông như một số nguyên, chẳng hạn "1", sẽ được lưu thành số nguyên 1. "01" không phải dạng chuẩn của số nguyên nên vẫn là chuỗi.

Lấy chỉ số trong foreach

Với một danh sách, khóa chính là chỉ số, nên chỉ cần foreach ($items as $i => $item). Mảng kết hợp không có vị trí dạng số, nên hãy giữ một biến đếm. Để xử lý riêng phần tử đầu hoặc cuối, so sánh khóa với array_key_first() hoặc 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" : ", ";
}

Vòng lặp cuối in dấu phẩy giữa các tên nhưng không in sau tên cuối cùng. Riêng việc này thì implode(', ', array_keys($scores)) ngắn hơn; phép kiểm tra array_key_last() dành cho khi lượt cuối cần logic khác, chứ không chỉ khác dấu phân cách.

Thay đổi giá trị mảng trong foreach (theo tham chiếu)

$value là một bản sao. Gán giá trị cho nó không thay đổi gì trong mảng. Để thay đổi mảng, hãy lặp theo tham chiếu với &$value, hoặc ghi ngược lại qua khóa.

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

Cả hai cách đều được. Cách dùng khóa không để lại trạng thái ẩn nào sau vòng lặp, vì vậy nhiều nhóm phát triển chuộng cách này. Nếu muốn tạo mảng mới thay vì sửa mảng cũ, array_map() là một lựa chọn khác.

Một câu hỏi liên quan: chuyện gì xảy ra nếu bạn thêm phần tử trong lúc lặp? foreach thông thường đi qua mảng ở trạng thái lúc vòng lặp bắt đầu, nên $prices[] = ... bên trong không tạo thêm lượt lặp. Vòng lặp theo tham chiếu đi qua mảng đang thay đổi và có ghé qua các phần tử mới.

Cái bẫy unset() với foreach theo tham chiếu

Sau foreach ($arr as &$v), biến $v vẫn là tham chiếu đến phần tử cuối của mảng. Nếu sau đó bạn dùng lại tên $v trong một vòng lặp thường, mỗi lượt sẽ ghi vào phần tử cuối đó. Chạy đoạn code này và nhìn vào phần tử cuối:

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

Vòng lặp thứ hai lần lượt gán A, rồi B, rồi chính giá trị của phần tử cuối vào $letters[2], và đến lượt cuối thì ô đó đã giữ B. Cách sửa chỉ là một dòng: đặt unset($v); ngay sau mỗi vòng foreach theo tham chiếu.

break và continue trong foreach

break rời khỏi vòng lặp, continue nhảy sang phần tử tiếp theo. Một mẫu thường gặp là tìm kiếm: lặp cho đến khi tìm thấy thứ cần tìm, rồi break để không phải kiểm tra phần còn lại của mảng.

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

Trong các vòng lặp lồng nhau, break 2 rời khỏi vòng lặp bên trong và cả vòng lặp bao quanh nó, còn continue 2 nhảy sang lượt tiếp theo của vòng lặp bên ngoài.

Mảng lồng nhau và foreach với list()

Các hàng dữ liệu là những mảng nằm trong một mảng. Hãy lặp qua các hàng rồi lặp qua từng hàng, hoặc lấy thẳng các trường ra ngay trên dòng foreach bằng destructuring mảng: [$a, $b] cho danh sách, ['key' => $var] cho các hàng dạng mảng kết hợp. list($a, $b) là cách viết cũ của [$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, " ";
}

Trang destructuring có thêm về cú pháp [...] =, bao gồm bỏ qua phần tử và mẫu lồng nhau.

Dựng danh sách hoặc bảng HTML với foreach

Trong template, dạng dấu hai chấm foreach (...): với endforeach; giúp vòng lặp dễ đọc khi nằm giữa các thẻ. Khối code này dựng một bảng, và tiêu đề cột là các liên kết: bấm vào một tiêu đề trong tab Trang, script sẽ chạy lại với $_GET['sort'] được gán giá trị, nên các hàng hiện ra theo thứ tự mới.

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

Hai thói quen đáng học từ khối code này: giá trị sort lấy từ URL được đối chiếu với danh sách các cột cho phép trước khi dùng, và mọi giá trị in vào HTML có thể chứa văn bản của người dùng đều đi qua htmlspecialchars().

foreach với null, mảng rỗng hoặc đối tượng

Mảng rỗng thì không sao: thân vòng lặp không bao giờ chạy. Còn null, một chuỗi hay một số thì không được: PHP in cảnh báo và bỏ qua vòng lặp. Với $tags = null; foreach ($tags as $tag), PHP in ra:

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

Chuyện này hay xảy ra nhất với dữ liệu lúc có lúc không, như một trường tùy chọn trong JSON đã giải mã. Hãy dùng ?? để thay bằng mảng rỗng:

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

Chữ object trong thông báo đó là thật: foreach trên một đối tượng sẽ đi qua các thuộc tính nhìn thấy được từ nơi vòng lặp chạy (bên ngoài lớp thì là các thuộc tính public), với tên thuộc tính làm khóa. Các lớp cài đặt Iterator hoặc IteratorAggregate, cũng như generator, tự quyết định foreach sẽ thấy gì.

foreach, for hay array_map

Cách chọn nhanh: nếu thân vòng lặp chỉ tính một giá trị mới cho mỗi phần tử, array_map(fn($x) => $x * 2, $a) diễn đạt điều đó trong một dòng. Nếu có tác dụng phụ (in ra, lưu lại, đếm nhiều thứ cùng lúc) hoặc cần break, hãy viết foreach.