(PHP 4, PHP 5, PHP 7, PHP 8)
foreach 語(yǔ)法結構提供了遍歷數組的簡(jiǎn)單方式。foreach
僅能夠應用于數組和對象，如果嘗試應用于其他數據類(lèi)型的變量，或者未初始化的變量將發(fā)出錯誤信息。有兩種語(yǔ)法：
foreach (iterable_expression as $value)
statement
foreach (iterable_expression as $key => $value)
statement
第一種格式遍歷給定的 iterable_expression
迭代器。每次循環(huán)中，當前單元的值被賦給 $value。
第二種格式做同樣的事，只除了當前單元的鍵名也會(huì )在每次循環(huán)中被賦給變量
$key。
注意 foreach 不會(huì )修改類(lèi)似 current()
和 key() 函數所使用的數組內部指針。
還能夠自定義遍歷對象。
可以很容易地通過(guò)在 $value 之前加上
& 來(lái)修改數組的元素。此方法將以引用賦值而不是拷貝一個(gè)值。
<?php
$arr = array(1, 2, 3, 4);
foreach ($arr as &$value) {
$value = $value * 2;
}
// 現在 $arr 是 array(2, 4, 6, 8)
unset($value); // 最后取消掉引用
?>
數組最后一個(gè)元素的 $value 引用在
foreach 循環(huán)之后仍會(huì )保留。建議使用
unset() 來(lái)將其銷(xiāo)毀。
否則你會(huì )遇到下面的情況：
<?php
$arr = array(1, 2, 3, 4);
foreach ($arr as &$value) {
$value = $value * 2;
}
// 現在 $arr 是 array(2, 4, 6, 8)
// 未使用 unset($value) 時(shí)，$value 仍然引用到最后一項 $arr[3]
foreach ($arr as $key => $value) {
// $arr[3] 會(huì )被 $arr 的每一項值更新掉…
echo "{$key} => {$value} ";
print_r($arr);
}
// 直到最終倒數第二個(gè)值被復制到最后一個(gè)值
// output:
// 0 => 2 Array ( [0] => 2, [1] => 4, [2] => 6, [3] => 2 )
// 1 => 4 Array ( [0] => 2, [1] => 4, [2] => 6, [3] => 4 )
// 2 => 6 Array ( [0] => 2, [1] => 4, [2] => 6, [3] => 6 )
// 3 => 6 Array ( [0] => 2, [1] => 4, [2] => 6, [3] => 6 )
?>
可以通過(guò)引用來(lái)遍歷數組常量的值：
<?php
foreach (array(1, 2, 3, 4) as &$value) {
$value = $value * 2;
}
?>
注意:
foreach不支持用 “@” 來(lái)抑制錯誤信息的能力。
示范用法的更多例子：
<?php
/* foreach 示例 1：僅 value */
$a = array(1, 2, 3, 17);
foreach ($a as $v) {
echo "Current value of \$a: $v.\n";
}
/* foreach 示例 2：value （打印手動(dòng)訪(fǎng)問(wèn)的符號以供說(shuō)明） */
$a = array(1, 2, 3, 17);
$i = 0; /* 僅供說(shuō)明 */
foreach ($a as $v) {
echo "\$a[$i] => $v.\n";
$i++;
}
/* foreach 示例 3：key 和 value */
$a = array(
"one" => 1,
"two" => 2,
"three" => 3,
"seventeen" => 17
);
foreach ($a as $k => $v) {
echo "\$a[$k] => $v.\n";
}
/* foreach 示例 4：多維數組 */
$a = array();
$a[0][0] = "a";
$a[0][1] = "b";
$a[1][0] = "y";
$a[1][1] = "z";
foreach ($a as $v1) {
foreach ($v1 as $v2) {
echo "$v2\n";
}
}
/* foreach 示例 5：動(dòng)態(tài)數組 */
foreach (array(1, 2, 3, 4, 5) as $v) {
echo "$v\n";
}
?>
(PHP 5 >= 5.5.0, PHP 7, PHP 8)
可以遍歷一個(gè)數組的數組并且把嵌套的數組解包到循環(huán)變量中，只需將 list() 作為值提供。
例如：
<?php
$array = [
[1, 2],
[3, 4],
];
foreach ($array as list($a, $b)) {
// $a 包含嵌套數組的第一個(gè)元素，
// $b 包含嵌套數組的第二個(gè)元素。
echo "A: $a; B: $b\n";
}
?>
以上例程會(huì )輸出：
A: 1; B: 2 A: 3; B: 4
list() 中的單元可以少于嵌套數組的，此時(shí)多出來(lái)的數組單元將被忽略：
<?php
$array = [
[1, 2],
[3, 4],
];
foreach ($array as list($a)) {
// 注意這里沒(méi)有 $b。
echo "$a\n";
}
?>
以上例程會(huì )輸出：
1 3
如果 list() 中列出的單元多于嵌套數組則會(huì )發(fā)出一條消息級別的錯誤信息：
<?php
$array = [
[1, 2],
[3, 4],
];
foreach ($array as list($a, $b, $c)) {
echo "A: $a; B: $b; C: $c\n";
}
?>
以上例程會(huì )輸出：
Notice: Undefined offset: 2 in example.php on line 7 A: 1; B: 2; C: Notice: Undefined offset: 2 in example.php on line 7 A: 3; B: 4; C: