while (list($key, $val) = each($arr)) { ... }
此為 PHP 早期(PHP 4/5 初期)遍歷陣列的經典寫法,結合三個構造:
[0=>key, 1=>val, 'key'=>key, 'value'=>val],並將指標後移;到達末端回傳 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 慢,函式呼叫開銷大 |
<?php
$methods = get_class_methods("Car");
// 僅需值
foreach ($methods as $val) {
echo "方法: $val<br>";
}
// 需鍵值
foreach ($methods as $key => $val) {
echo "方法 $key => $val<br>";
}
?>
<?php
$keys = array_keys($methods); // [0, 1, 2]
$vals = array_values($methods); // ['start', 'stop', 'speedUp']
?>
<?php
array_walk($methods, function($val, $key) {
echo "方法 $key => $val<br>";
});
?>
<?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
reset($arr); // 必須重置
while (list($k, $v) = each($arr)) {
// 處理
}
?>
<?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() 應列為重構優先項目。