PHP foreach 循环：键值、索引和引用

foreach ($array as $value) 对每个元素运行一次代码块，$value 被设置为当前元素。要同时拿到键，就写 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 适用于任何数组，不管它的键是什么，你也不需要管理计数器或检查长度。它是你在 PHP 中最常写的循环。

遍历键和值

在 $key => $value 中，变量名由你自己决定：$name => $age、$id => $user、$k => $v。在列表中，键是位置 0, 1, 2。在关联数组中，键是你定义的字符串键。

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

最后一个循环展示了一个容易让人意外的细节：看起来像整数的字符串键，比如 "1"，会被存储为整数 1。"01" 不是规范的整数形式，所以它仍然是字符串。

在 foreach 中获取索引

在列表中，键就是索引，所以 foreach ($items as $i => $item) 就够了。关联数组没有数字位置，所以要自己维护一个计数器。要对第一个或最后一个元素做特殊处理，就把键和 array_key_first() 或 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" : ", ";
}

最后一个循环在名字之间输出逗号，但最后一个名字后面不输出。单就这件事而言，implode(', ', array_keys($scores)) 更简短；array_key_last() 的判断适用于最后一轮需要不同逻辑的情况，而不只是换一个分隔符。

在 foreach 中修改数组的值（按引用）

$value 是一个副本。给它赋值不会改变数组中的任何内容。要修改数组，要么用 &$value 按引用遍历，要么通过键写回。

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

两种方法都可以。通过键的写法在循环结束后不会留下隐藏的状态，所以很多团队更喜欢它。如果是要生成一个新数组而不是修改原数组，array_map() 也是一种选择。

一个相关的问题：如果在循环中添加元素会怎样？普通的 foreach 遍历的是循环开始时的数组，所以在循环中写 $prices[] = ... 不会增加循环的轮数。按引用的循环遍历的是实时的数组，会访问到新增的元素。

按引用 foreach 时 unset() 的陷阱

foreach ($arr as &$v) 结束后，变量 $v 仍然是对数组最后一个元素的引用。如果之后在普通循环中再次使用 $v 这个名字，每一轮都会写进最后那个元素。运行下面的代码，看看最后一项：

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

第二个循环依次把 A、B，最后是最后一个元素自身的值赋给 $letters[2]，而到最后一轮时，这个位置已经是 B 了。修复只需要一行：在每个按引用的 foreach 之后紧接着写 unset($v);。

foreach 中的 break 和 continue

break 退出循环，continue 跳到下一个元素。一种常见用法是查找：一直循环到找到需要的东西，然后 break，这样就不会再检查数组的其余部分。

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

在嵌套循环中，break 2 会同时退出内层循环和它外面的一层，continue 2 则跳到外层循环的下一轮。

嵌套数组和在 foreach 中使用 list()

一行行数据就是数组里的数组。可以先遍历各行，再遍历每一行；也可以在 foreach 那一行直接用数组解构取出字段：列表用 [$a, $b]，关联数组的行用 ['key' => $var]。list($a, $b) 是 [$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, " ";
}

解构页面详细介绍了 [...] = 语法，包括跳过元素和嵌套模式。

用 foreach 生成 HTML 列表或表格

在模板中，使用冒号形式的 foreach (...): 加 endforeach;，能让夹在标签之间的循环更易读。这段代码生成一个表格，表头是链接：在“页面”标签页中点击其中一个，同一个脚本会带着设置好的 $_GET['sort'] 再运行一次，各行就会按新的顺序排列。

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

这段代码中有两个值得借鉴的习惯：URL 中的 sort 值在使用前会先和允许的列名列表比对；输出到 HTML 中、可能含有用户文本的每个值，都经过了 htmlspecialchars() 处理。

对 null、空数组或对象使用 foreach

空数组没问题：循环体一次也不会运行。null、字符串或数字就不行了：PHP 会输出一条警告并跳过循环。对于 $tags = null; foreach ($tags as $tag)，它会输出：

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

这种情况最常出现在有时会缺失的数据上，比如解码后的 JSON 中的可选字段。用 ?? 回退到空数组：

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

那条信息中的 object 是真的：对对象使用 foreach 会访问它在循环所在位置可见的属性（在类的外部就是公有属性），以属性名作为键。实现了 Iterator 或 IteratorAggregate 的类，以及生成器，会自行决定 foreach 能看到什么。

foreach、for 与 array_map 的区别

一个快速的判断方法：如果循环体只是为每个元素计算一个新值，array_map(fn($x) => $x * 2, $a) 一行就能表达。如果它有副作用（输出、保存、同时统计多个东西）或者需要 break，就写 foreach。