foreach 是 PHP 遍歷數組/對象最常用的結構,但其「按值遍歷」與「按引用遍歷」的行為差異、內部指針操作、循環中修改數組等特性,極易導致難以排查的 Bug。本文結合 Zend 引擎原理,徹底講透 foreach 行為。
| 場景 | 行為 | 建議 |
|---|---|---|
按值遍歷 foreach ($arr as $v) | 複製值(Copy-on-Write),修改 $v 不影響原數組 | 默認首選,安全 |
按引用遍歷 foreach ($arr as &$v) | $v 為元素引用,修改 $v 直接修改原數組 | 需修改原數組時使用,**循環後必須 unset($v)** |
| 按引用遍歷後,再按值遍歷同一數組 | 第二個循環的賦值操作會修改最後一個元素(因 $v 仍引用它) | **嚴重陷阱**,循環間必須 unset($v) |
| 循環中增刪數組元素 | 基於內部指針,可能跳過元素、重複處理、無限循環 | 避免;需修改結構請先複製數組或收集操作後統一應用 |
key()/current() 在 foreach 中 | 不受 foreach 影響,操作的是數組**副本**的內部指針(PHP 7+) | 不要在 foreach 中混用這些函數 |
<?php
$arr = [1, 2, 3];
// 第一輪:按引用修改
foreach ($arr as $k => &$v) {
$v *= 2;
}
// 此時 $arr = [2, 4, 6],但 $v 仍引用 $arr[2] (值 6)
echo "第一輪後: "; print_r($arr); // [2, 4, 6]
// 第二輪:按值讀取(未 unset $v!)
foreach ($arr as $k => $v) {
echo "$k => $v\n";
}
/*
輸出:
0 => 2
1 => 4
2 => 2 <-- 錯誤!應為 6
*/
// 原因:第二輪 foreach 隱含 $v = $arr[0]; $v = $arr[1]; $v = $arr[2];
// 因 $v 仍引用 $arr[2],賦值相當於 $arr[2] = $arr[0] → 2, 然後 $arr[2] = $arr[1] → 4
?>
<?php
$arr = [1, 2, 3];
foreach ($arr as $k => &$v) { $v *= 2; }
unset($v); // 關鍵:斷開引用
foreach ($arr as $k => $v) { echo "$k => $v\n"; }
// 正確輸出:0=>2, 1=>4, 2=>6
?>
<?php
$arr = [1, 2, 3, 4, 5];
// 刪除元素:導致指針錯位,跳過下一個元素
foreach ($arr as $k => $v) {
if ($v === 3) unset($arr[$k]);
}
print_r($arr); // [1, 2, 4, 5] 看似正常,但內部指針已亂
// 更危險:插入元素可能導致無限循環
$arr = [1, 2];
foreach ($arr as $k => $v) {
if ($v === 1) $arr[] = 3; // 不斷添加,foreach 會遍歷新增元素!
if (count($arr) > 10) break; // 強制中斷防死循環
}
?>
<?php
$arr = [1, 2, 3, 4, 5];
$toRemove = [];
$toAdd = [];
foreach ($arr as $k => $v) {
if ($v % 2 === 0) $toRemove[] = $k;
if ($v === 3) $toAdd[] = 99;
}
foreach ($toRemove as $k) unset($arr[$k]);
$arr = array_merge($arr, $toAdd); // 或 array_splice 插入指定位置
?>
fe_pos (HashTable 內部指針) 到 execute_data->Ts。zend_hash_set_pointer 恢復指針 → zend_hash_get_current_data 取值 → zend_hash_move_forward 移動指針 → 保存新 fe_pos。按值模式下還會 ZVAL_COPY 複製值(COW)。zval*,無複製,修改即修改原數組。fe_pos 保存末尾位置。<?php
$arr = ['a', 'b', 'c'];
foreach ($arr as $k => $v) {
echo key($arr), '=>', current($arr), "\n"; // PHP 5: 1=>b, 1=>b, 1=>b (指針被 foreach 移動)
// PHP 7+: 0=>a, 1=>b, 2=>c (foreach 操作副本指針)
}
?>
PHP 7 引入 zend_array_duplicate 為 foreach 創建 HashTable 副本(按值模式),內部指針操作互不干擾。但**引用模式仍操作原數組指針**。
<?php
class Collection implements IteratorAggregate
{
private array $items = [];
public function add($item) { $this->items[] = $item; }
public function getIterator(): Traversable { return new ArrayIterator($this->items); }
}
$col = new Collection();
$col->add('a'); $col->add('b');
foreach ($col as $v) { echo $v; } // 正常遍歷
?>
foreach ($arr as $v),除非需要修改原數組元素值。unset($v)**,寫入代碼規範/靜態分析規則(PHPStan/Psalm 會提示)。array_filter/array_map。 key()/current()/next()/prev()/reset()/end()**,它們操作的是副本或原數組指針,行為不可預期。function getRows() { while($row=$stmt->fetch()) yield $row; }。foreach (array $arr as $k => $v) (PHP 8.1+)。理解 foreach 的 **複製語義(按值)**、**引用綁定(按引用)**、**內部指針隔離(PHP 7+ 副本機制)**,並養成 **「引用必 unset」「不邊遍歷邊修改結構」** 的習慣,能消除 90% 的 foreach 相關 Bug。