萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP foreach 遍歷陣列完全指南:一維/二維/巢狀、鍵值存取、效能與遞迴替代方案

前言

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 仍參考最後一個元素,後續程式碼若重用該變數會汙染陣列。

二、二維與巢狀陣列遍歷

巢狀 foreach(已知固定層級)

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

HTML 清單輸出範例(原文重構)

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

進階:array_combine() 快速建立關聯

<?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 或資料庫游標分批處理
遍歷中增刪元素行為未定義(可能跳過/重複/錯誤)先收集需處理的鍵,遍歷後再操作

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 限制與遞迴替代方案

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

六、常見錯誤與最佳實踐

  1. 忘記 unset($value) 導致參考殘留汙染。
  2. 遍歷中 unset($arr[$key]):PHP 7+ 支援,但建議收集鍵名後統一刪除。
  3. 字串當陣列遍歷:foreach ('abc' as $c) 會逐字元遍歷(PHP 7.1+ 棄用,8.0+ 錯誤)。
  4. 物件遍歷:預設遍歷 visible 屬性,實作 Iterator/IteratorAggregate 可自訂行為。
  5. 嚴格型別宣告:foreach (array $arr as $v)(PHP 8.1+)確保輸入為陣列。

結語

foreach 是 PHP 最優雅的遍歷工具。掌握值/參考傳遞、鍵值解構、巢狀遞迴/迭代替代、Generator 串流處理,能優雅解決 99% 遍歷需求。記住:修改原陣列用 &$v 並 unset();超大資料用 Generator;任意深度用遞迴/堆疊。

copyright © 萬盛學電腦網 all rights reserved