foreach 是 PHP 遍歷陣列與可迭代物件的專用結構,語法簡潔、自動處理內部指標、支援參考傳遞修改原值。本文將從兩種基本語法延伸至多維陣列遍歷、鍵值關聯操作、效能特性與遞迴替代方案,並釐清常見誤區。
foreach ($arr as $value)<?php
$fruits = ['apple', 'banana', 'orange'];
foreach ($fruits as $fruit) {
echo $fruit . '<br>';
}
// 輸出:apple banana orange
?>
$value 為值的副本(Copy-on-Write),修改不影響原陣列。foreach ($arr as $key => $value)<?php
$user = ['name' => 'Alice', 'age' => 28, 'city' => 'Taipei'];
foreach ($user as $key => $value) {
echo "$key: $value<br>";
}
// 輸出:name: Alice age: 28 city: Taipei
?>
&$value<?php
$numbers = [1, 2, 3];
foreach ($numbers as &$num) {
$num *= 2;
}
unset($num); // 必須解除參考!
print_r($numbers); // [2, 4, 6]
?>
⚠️ 必須
unset($value):否則$value仍參考最後一個元素,後續程式碼若重用該變數會汙染陣列。
<?php
$matrix = [
['id' => 1, 'scores' => [80, 90, 85]],
['id' => 2, 'scores' => [70, 95, 88]],
];
foreach ($matrix as $row) {
echo "學生 {$row['id']}: ";
foreach ($row['scores'] as $score) {
echo "$score ";
}
echo "<br>";
}
?>
<?php
$categories = [
'前端' => ['Vue', 'React', 'Svelte'],
'後端' => ['PHP', 'Node.js', 'Go'],
'資料庫' => ['MySQL', 'PostgreSQL', 'Redis'],
];
echo '<ul>';
foreach ($categories as $cat => $techs) {
echo "<li>$cat<ul>";
foreach ($techs as $tech) {
echo "<li>$tech</li>";
}
echo '</ul></li>';
}
echo '</ul>';
?>
原文範例:科目陣列與分數陣列鍵名對應。
<?php
$subjects = ['1' => '國文', '2' => '數學', '3' => '英文'];
$scores = ['1' => '95', '2' => '99', '3' => '92'];
foreach ($subjects as $key => $subject) {
echo "$subject: {$scores[$key]}<br>";
}
// 輸出:國文: 95 數學: 99 英文: 92
?>
$key 是陣列索引(鍵名),而非值。$subjects['1'] 才能取得 '國文',因此對應分數必須用 $scores[$key],而非 $scores[$subject]。
<?php
$keys = ['name', 'age', 'city'];
$values = ['Bob', 30, 'Kaohsiung'];
$profile = array_combine($keys, $values);
// ['name' => 'Bob', 'age' => 30, 'city' => 'Kaohsiung']
?>
| 場景 | 記憶體行為 | 建議 |
|---|---|---|
| 大陣列僅讀遍歷 | Copy-on-Write,幾乎零額外記憶體 | 直接用 foreach ($arr as $v) |
| 需修改原陣列 | 參考 &$v 避免複製整個陣列 | 結束後 unset($v) |
| 超大陣列(百萬級) | foreach 仍需將整個陣列載入記憶體 | 改用 Generator 或資料庫游標分批處理 |
| 遍歷中增刪元素 | 行為未定義(可能跳過/重複/錯誤) | 先收集需處理的鍵,遍歷後再操作 |
<?php
function readLargeCsv($path) {
$handle = fopen($path, 'r');
while (($row = fgetcsv($handle)) !== false) {
yield $row; // 一次產生一行
}
fclose($handle);
}
foreach (readLargeCsv('huge.csv') as $row) {
// 處理單行,記憶體恆定
}
?>
限制:
foreach僅能遍歷單層陣列/可迭代物件。三維以上巢狀結構需遞迴或堆疊迭代。
<?php
function walkArray(array $array, int $depth = 0): void {
foreach ($array as $key => $value) {
echo str_repeat(' ', $depth) . "$key => ";
if (is_array($value)) {
echo "<br>";
walkArray($value, $depth + 1);
} else {
echo "$value<br>";
}
}
}
$data = [
'level1' => [
'level2a' => 'value A',
'level2b' => [
'level3' => 'value B',
],
],
];
walkArray($data);
?>
<?php
function walkArrayIterative(array $array): void {
$stack = [['arr' => $array, 'depth' => 0]];
while ($stack) {
$frame = array_pop($stack);
foreach ($frame['arr'] as $key => $value) {
echo str_repeat(' ', $frame['depth']) . "$key => ";
if (is_array($value)) {
echo "<br>";
$stack[] = ['arr' => $value, 'depth' => $frame['depth'] + 1];
} else {
echo "$value<br>";
}
}
}
}
?>
unset($value) 導致參考殘留汙染。unset($arr[$key]):PHP 7+ 支援,但建議收集鍵名後統一刪除。foreach ('abc' as $c) 會逐字元遍歷(PHP 7.1+ 棄用,8.0+ 錯誤)。visible 屬性,實作 Iterator/IteratorAggregate 可自訂行為。foreach (array $arr as $v)(PHP 8.1+)確保輸入為陣列。foreach 是 PHP 最優雅的遍歷工具。掌握值/參考傳遞、鍵值解構、巢狀遞迴/迭代替代、Generator 串流處理,能優雅解決 99% 遍歷需求。記住:修改原陣列用 &$v 並 unset();超大資料用 Generator;任意深度用遞迴/堆疊。