您现在的位置：程式碼之家 >> 編程語言 > >> 網頁程式設計 >> PHP 程式設計 >> PHP 相關知識

PHP 陣列遍歷完全指南：foreach/for/while/list/each/key 及多維遞歸

編輯：PHP 相關知識

PHP 提供多種陣列遍歷方式，各有語義差異與性能特點。本文系統對比 foreach、for、while+list+each、key、遞歸遍歷，給出選型建議與最佳實踐。

核心遍歷方式對比

方式	適用場景	鍵值獲取	內部指針	性能	修改原陣列
foreach	絕大多數場景	$k => $v / $v	不影響	最快	值傳遞（引用可修改）
for	數值索引、需索引運算	$i => $arr[$i]	不影響	快	直接修改
while+list+each	歷史代碼、需手動控制指針	list($k,$v)	前移	慢	直接修改
key/next/current	極少數底層控制	key() / current()	手動	最慢	直接修改

foreach：首選標準

$colors = ['red', 'blue', 'green'];

// 僅值
foreach ($colors as $color) { ... }

// 鍵值
foreach ($colors as $key => $color) { ... }

// 引用修改原陣列
foreach ($data as &$row) {
    $row['processed'] = true;
}
unset($row); // 重要：斷開引用

PHP 7+ 複製陣列而非引用，修改不影響原陣列（除非用 &）；
遍歷順序 = 插入順序（有序映射特性）；
不可在循環中 unset($arr[$key]) 導致跳過元素，改用 array_filter。

for：數值索引專用

$arr = ['zero', 'one', 'two'];
for ($i = 0, $len = count($arr); $i < $len; $i++) {
    echo $arr[$i];
}

// 反向遍歷
for ($i = count($arr) - 1; $i >= 0; $i--) { ... }

需確保連續數值索引（array_values 重建）；
適合需索引運算（如兩兩比較、滑動窗口）。

while + list + each：歷史遺留

$colors = ['red', 'blue', 'green'];
reset($colors); // 重置指針
while (list($key, $val) = each($colors)) {
    echo "$key => $val\n";
}

each() 返回 [1=>val, 'value'=>val, 0=>key, 'key'=>key]；
PHP 7.2 棄用，8.0 移除，**新代碼禁用**；
遷移直接改 foreach。

key/next/current：手動指針控制

$capitals = ['Ohio' => 'Columbus', 'Iowa' => 'Des Moines'];
while ($key = key($capitals)) {
    echo $key . "\n";
    next($capitals); // 必須手動前移
}

key() 不移動指針，需配合 next()；
極少見，除非實現自定義迭代器。

多維陣列遞歸遍歷

function array_recursive_iter(array $arr, callable $callback, int $depth = 0): void {
    foreach ($arr as $key => $val) {
        if (is_array($val)) {
            array_recursive_iter($val, $callback, $depth + 1);
        } else {
            $callback($key, $val, $depth);
        }
    }
}

// 使用：扁平化輸出所有葉子值
$flat = [];
array_recursive_iter($data, function($k, $v) use (&$flat) {
    $flat[] = $v;
});

現代替代：ArrayIterator / RecursiveArrayIterator

$it = new RecursiveIteratorIterator(new RecursiveArrayIterator($data));
foreach ($it as $key => $val) {
    echo str_repeat('  ', $it->getDepth()) . "$key => $val\n";
}

// 過濾葉子節點
$leaves = new RegexIterator($it, '/./', RecursiveRegexIterator::GET_MATCH);