萬盛學電腦網

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

PHP 陣列遍歷完全指南:foreach、list()、each()、while 迴圈差異與最佳實踐

前言

陣列遍歷是 PHP 開發最高頻操作之一。從早期的 while(list()) = each() 到現代的 foreach,語法演進帶來更清晰的語意與更好效能。本文詳細比較各種遍歷方式、內部指標機制、多維陣列處理與效能差異。

foreach:現代標準遍歷方式

基本語法

<?php
$prices = ['apple' => 10, 'orange' => 20, 'banana' => 30];

// 鍵值對遍歷
foreach ($prices as $key => $value) {
    echo "$key => $price\n";
}

// 僅需值
foreach ($prices as $value) {
    echo "$value\n";
}

// 需修改原陣列值:使用參考 &
foreach ($prices as $key => &$value) {
    $value *= 1.1; // 漲價 10%
}
unset($value); // 必須解除參考!
?>

foreach 核心特性

  • 複製陣列進行遍歷(PHP 7 前複製整個陣列,PHP 7+ 複製引用計數,修改時才複製 - Copy-on-Write)
  • 不影響內部指標:current(), next(), reset() 等函式不受 foreach 影響
  • 可直接修改值(搭配 & 參考)
  • 支援陣列解構(PHP 7.1+):foreach ($arr as [$a, $b])

傳統組合:while + list() + each()

語法與運作原理

<?php
$fruits = ['apple' => 10, 'orange' => 20, 'banana' => 30];

// each() 回傳當前鍵值並將內部指標前進
// list() 將陣列解構賦值給變數
while (list($key, $value) = each($fruits)) {
    echo "$key => $value\n";
}
// 輸出:
// apple => 10
// orange => 20
// banana => 30
?>

each() 回傳結構

<?php
$arr = ['a' => 1, 'b' => 2];
print_r(each($arr));
/*
Array
(
    [1] => 1
    [value] => 1
    [0] => a
    [key] => a
)
*/
?>

關鍵差異:內部指標與重置機制

foreach 不影響內部指標

<?php
$arr = ['a', 'b', 'c'];

foreach ($arr as $v) {
    echo "foreach: $v\n";
}

echo "current: " . current($arr) . "\n"; // a(指標未動)
echo "next: " . next($arr) . "\n";       // b
?>

each() 會移動內部指標

<?php
$arr = ['a', 'b', 'c'];

each($arr); // 移動到 b
each($arr); // 移動到 c

echo current($arr); // c

reset($arr); // 重置指標到開頭
echo current($arr); // a
?>

混用陷阱:foreach 後接 while(list/each) 需 reset()

<?php
$prices = ['apple' => 10, 'orange' => 20, 'banana' => 30];

foreach ($prices as $k => $v) {
    echo "foreach: $k => $v\n";
}

// 此時 each() 內部指標仍在開頭(foreach 不影響)
// 但若先用 each() 遍歷完,再用 foreach,則 foreach 會從頭開始(複製陣列)

// 正確混用模式:
reset($prices); // 確保指標在開頭
while (list($k, $v) = each($prices)) {
    echo "while: $k => $v\n";
}
?>

list() 陣列解構賦值

基本用法

<?php
$info = ['Alice', 25, 'Taipei'];

// 傳統 list()
list($name, $age, $city) = $info;
echo "$name, $age, $city"; // Alice, 25, Taipei

// PHP 7.1+ 短陣列語法解構
[$name, $age, $city] = $info;

// 指定鍵名解構(PHP 7.1+)
$data = ['name' => 'Bob', 'age' => 30, 'city' => 'Kaohsiung'];
['name' => $name, 'age' => $age, 'city' => $city] = $data;

// 跳過不需要的值
[$first, , $third] = [1, 2, 3]; // $first=1, $third=3
?>

搭配資料庫查詢結果

<?php
// PDO fetch 回傳關聯陣列
$stmt = $pdo->query('SELECT id, name, email FROM users LIMIT 1');
$row = $stmt->fetch();

// 解構賦值
['id' => $id, 'name' => $name, 'email' => $email] = $row;
?>

多維陣列遍歷策略

遞迴遍歷

<?php
function printArray($array, $indent = 0) {
    foreach ($array as $key => $value) {
        echo str_repeat('  ', $indent) . "[$key] => ";
        if (is_array($value)) {
            echo "\n";
            printArray($value, $indent + 1);
        } else {
            echo "$value\n";
        }
    }
}

$data = [
    'user' => [
        'name' => 'Alice',
        'address' => ['city' => 'Taipei', 'zip' => '100']
    ],
    'posts' => [
        ['title' => 'Post 1'],
        ['title' => 'Post 2']
    ]
];
printArray($data);
?>

RecursiveArrayIterator(SPL 標準庫)

<?php
$iterator = new RecursiveIteratorIterator(
    new RecursiveArrayIterator($data),
    RecursiveIteratorIterator::SELF_FIRST
);

foreach ($iterator as $key => $value) {
    $depth = $iterator->getDepth();
    echo str_repeat('  ', $depth) . "[$key] => $value\n";
}
?>

效能比較與選擇指南

微效能測試(100萬元素陣列)

<?php
$arr = range(1, 1000000);

$start = microtime(true);
foreach ($arr as $v) { $sum += $v; }
echo "foreach: " . (microtime(true) - $start) . "s\n"; // ~0.03s

$start = microtime(true);
$i = 0; $len = count($arr);
while ($i < $len) { $sum += $arr[$i++]; }
echo "while+index: " . (microtime(true) - $start) . "s\n"; // ~0.04s

$start = microtime(true);
reset($arr);
while (list($k, $v) = each($arr)) { $sum += $v; }
echo "while+each: " . (microtime(true) - $start) . "s\n"; // ~0.08s (較慢)
?>

選擇建議決策樹

  1. 一般遍歷、唯讀、需鍵值 → foreach ($arr as $k => $v)
  2. 需修改原陣列值 → foreach ($arr as $k => &$v) + unset($v)
  3. 需控制內部指標、配合 current/next/prev → while(list($k,$v)=each($arr))(罕見)
  4. 簡單索引陣列、需效能極致 → for ($i=0; $i(避免 foreach 複製開銷,PHP 7+ 差異極小)
  5. 多維陣列遞迴 → RecursiveArrayIterator 或自訂遞迴函式
  6. 陣列解構賦值 → [$a, $b] = $arr 或 ['key'=>$v] = $arr

常見錯誤與除錯

錯誤原因修正
foreach 修改值不生效未使用參考 &foreach ($arr as $k => &$v)
foreach 後陣列最後元素被汙染未 unset($v) 解除參考迴圈結束後必須 unset($v)
each() 回傳 false 導致無限迴圈陣列為空或指標已到末尾迴圈前 reset($arr),或檢查 !== false
list() 參數數量不符陣列元素少於變數使用 [$a, $b] = $arr + [null, null] 設定預設值

結語

foreach 是現代 PHP 陣列遍歷的首選,語法清晰、效能優異、不干擾內部指標。while(list()) = each() 是歷史遺留寫法,僅在需精確控制內部指標的特殊場景使用。掌握 list()/短陣列語法解構賦值,能大幅提升處理資料庫結果、API 回應、設定檔等結構化資料的效率。記住:參考遍歷後必須 unset(),這是避免難以重現 Bug 的關鍵習慣。

copyright © 萬盛學電腦網 all rights reserved