萬盛學電腦網

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

PHP while(list($key,$val)=each($arr)) 陣列遍歷詳解與現代替代方案

語法解析

while (list($key, $val) = each($arr)) { ... }

此為 PHP 早期(PHP 4/5 初期)遍歷陣列的經典寫法,結合三個構造:

  1. each($arr):回傳當前指標位置的鍵值對陣列 [0=>key, 1=>val, 'key'=>key, 'value'=>val],並將指標後移;到達末端回傳 false
  2. list($key, $val):將陣列值解包賦予多個變數(僅支援數字索引 0,1)
  3. while():當 each() 回傳非 false 時持續迴圈

完整執行範例

<?php
class Car {
    public function start() { echo "引擎啟動<br>"; }
    public function stop() { echo "熄火<br>"; }
    public function speedUp() { echo "加速<br>"; }
}

// 取得類別所有方法名
$methods = get_class_methods("Car");
// 結果:['start', 'stop', 'speedUp']

echo "類別 Car 的所有方法:<br>";

while (list($key, $val) = each($methods)) {
    echo "方法 $key => $val<br>";
}

/* 輸出:
方法 0 => start
方法 1 => stop
方法 2 => speedUp
*/
?>

底層運作流程圖解

陣列內部指標初始位置:開始前
         ↓ each()
回傳 [0=>'0', 1=>'start', 'key'=>0, 'value'=>'start'],指標後移
         ↓ list($key,$val) 取陣列索引 0,1
$key=0, $val='start' → 執行迴圈主體
         ↓ each()
回傳 [0=>'1', 1=>'stop', 'key'=>1, 'value'=>'stop'],指標後移
         ↓ list($key,$val)
$key=1, $val='stop' → 執行迴圈主體
         ↓ each()
回傳 [0=>'2', 1=>'speedUp', 'key'=>2, 'value'=>'speedUp'],指標後移
         ↓ list($key,$val)
$key=2, $val='speedUp' → 執行迴圈主體
         ↓ each()
回傳 false(指標超出末端) → while 條件失效 → 結束迴圈

關鍵注意事項

議題說明
指標狀態each() 依賴陣列內部指標,迴圈前需 reset($arr) 確保從頭開始
修改陣列迴圈中增刪元素會導致指標錯亂,極度不建議
list() 限制只能解包數字索引 0,1,無法直接取 'key'/'value' 字串鍵
PHP 7.2 棄用each() 在 PHP 7.2 發出 E_DEPRECATED,PHP 8.0 移除
效能比 foreach 慢,函式呼叫開銷大

現代替代方案(推薦)

1. foreach(標準、最佳效能、語意清晰)

<?php
$methods = get_class_methods("Car");

// 僅需值
foreach ($methods as $val) {
    echo "方法: $val<br>";
}

// 需鍵值
foreach ($methods as $key => $val) {
    echo "方法 $key => $val<br>";
}
?>

2. array_keys() / array_values() 取得獨立鍵值陣列

<?php
$keys = array_keys($methods);   // [0, 1, 2]
$vals = array_values($methods); // ['start', 'stop', 'speedUp']
?>

3. array_walk() 回呼處理

<?php
array_walk($methods, function($val, $key) {
    echo "方法 $key => $val<br>";
});
?>

4. Iterator 介面(物件遍歷)

<?php
class MethodCollection implements Iterator {
    private $methods = [];
    private $position = 0;
    
    public function __construct($className) {
        $this->methods = get_class_methods($className);
    }
    
    public function current() { return $this->methods[$this->position]; }
    public function key() { return $this->position; }
    public function next() { $this->position++; }
    public function rewind() { $this->position = 0; }
    public function valid() { return isset($this->methods[$this->position]); }
}

foreach (new MethodCollection("Car") as $key => $val) {
    echo "$key => $val<br>";
}
?>

遷移指南:舊碼重構

❌ 舊寫法(PHP 7.2+ 棄用警告)

<?php
reset($arr); // 必須重置
while (list($k, $v) = each($arr)) {
    // 處理
}
?>

✅ 新寫法(PHP 5.4+ 完整支援)

<?php
// 簡單替換
foreach ($arr as $k => $v) {
    // 處理
}

// 若需保留 each() 的「指標狀態」語意(罕見需求)
// 改用 ArrayIterator
$it = new ArrayIterator($arr);
while ($it->valid()) {
    $k = $it->key();
    $v = $it->current();
    // 處理
    $it->next();
}
?>

特殊場景:多維陣列逐行解包

list() 配合 each() 曾常用於解包多維陣列列,現代寫法更清晰:

<?php
$staff = [
    ["小張", "男", 24],
    ["小王", "女", 25],
    ["小李", "男", 23]
];

// 舊寫法
while (list($k, $v) = each($staff)) {
    list($name, $sex, $age) = $v;
    echo "$name $sex $age<br>";
}

// 現代寫法:foreach 直接解包(PHP 7.1+)
foreach ($staff as [$name, $sex, $age]) {
    echo "$name $sex $age<br>";
}

// 或 list() 在 foreach 中(PHP 5.5+)
foreach ($staff as list($name, $sex, $age)) {
    echo "$name $sex $age<br>";
}
?>

總結

while(list($k,$v)=each($arr)) 是 PHP 歷史遺留寫法,已棄用並移除。現代專案請一律使用 foreach,語法更簡潔、效能更好、功能更強(支援解包、引用、IteratorAggregate 等)。維護舊專案時,遇到 each() 應列為重構優先項目。

copyright © 萬盛學電腦網 all rights reserved