PHP Conference Japan 2024

    foreach

    (PHP 4, PHP 5, PHP 7, PHP 8)

    foreach 建構提供了一個簡單的方式來迭代陣列。 foreach 僅適用於陣列和物件，當您嘗試將其用於不同資料類型的變數或未初始化的變數時，它將發出錯誤。有兩種語法：

    foreach (iterable_expression as $value)
    statement
foreach (iterable_expression as $key => $value)
    statement

    第一種形式遍歷由 iterable_expression 給出的可迭代物件。在每次迭代中，目前元素的值會被賦值給 $value。

    第二種形式還會在每次迭代中將目前元素的鍵值賦值給 $key 變數。

    請注意，foreach 不會修改內部陣列指標，該指標由 current() 和 key() 等函式使用。

    可以自訂物件迭代。

    若要在迴圈中直接修改陣列元素，請在 $value 前加上 &。這樣一來，值將會以參考方式賦值。

    <?php
    $arr     = array(1, 2, 3, 4);
    foreach (    $arr as &$value) {
    $value = $value * 2;
    }
    // $arr 現在是 array(2, 4, 6, 8)
    unset($value); // 解除與最後一個元素的參考連結
    ?>

    警告

    $value 的參考以及最後一個陣列元素，即使在 foreach 迴圈結束後仍然存在。建議使用 unset() 將其銷毀。否則，您將會遇到以下行為：

    <?php
    $arr     = array(1, 2, 3, 4);
    foreach (    $arr as &$value) {
    $value = $value * 2;
    }
    // $arr 現在是 array(2, 4, 6, 8)

    // 如果沒有 unset($value)，$value 仍然會參考最後一個項目：$arr[3]

    foreach ($arr as $key => $value) {
    // $arr[3] 將會隨著 $arr 中的每個值更新...
    echo "{$key} => {$value} ";
    print_r($arr);
    }
    // ...直到最後倒數第二個值被複製到最後一個值

    // 輸出：
    // 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 )
    ?>

    可以透過參考方式迭代常數陣列的值。

    <?php
    foreach (array(1, 2, 3, 4) as &$value) {
    $value = $value * 2;
    }
    ?>

    備註:

    foreach 不支援使用 @ 來抑制錯誤訊息。

    更多使用範例

    <?php
    /* foreach example 1: value only */

    $a = array(1, 2, 3, 17);

    foreach (    $a as $v) {
    echo     "Current value of \$a: $v.\n";
    }

    /* foreach example 2: value (with its manual access notation printed for illustration) */

    $a = array(1, 2, 3, 17);

    $i = 0; /* for illustrative purposes only */

    foreach ($a as $v) {
    echo     "\$a[$i] => $v.\n";
    $i++;
    }

    /* foreach example 3: key and value */

    $a = array(
    "one" => 1,
    "two" => 2,
    "three" => 3,
    "seventeen" => 17
    );

    foreach (    $a as $k => $v) {
    echo     "\$a[$k] => $v.\n";
    }

    /* foreach example 4: multi-dimensional arrays */
    $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 example 5: dynamic arrays */

    foreach (array(1, 2, 3, 4, 5) as $v) {
    echo     "$v\n";
    }
    ?>

    使用 list() 解封巢狀陣列

    (PHP 5 >= 5.5.0, PHP 7, PHP 8)

    可以透過提供 list() 作為值，迭代陣列中的陣列，並將巢狀陣列解封到迴圈變數中。

    例如：

    <?php
    $array     = [
    [    1, 2],
    [    3, 4],
    ];

    foreach (    $array as list($a, $b)) {
    // $a 包含巢狀陣列的第一個元素，
    // $b 包含第二個元素。
    echo "A: $a; B: $b\n";
    }
    ?>

    上述範例將輸出：

    A: 1; B: 2
A: 3; B: 4

    您可以在 list() 中提供的元素少於巢狀陣列中的元素，在這種情況下，剩餘的陣列值將被忽略。

    <?php
    $array     = [
    [    1, 2],
    [    3, 4],
    ];

    foreach (    $array as list($a)) {
    // 注意這裡沒有 $b。
    echo "$a\n";
    }
    ?>

    上述範例將輸出：

    1
3

    如果沒有足夠的陣列元素來填滿 list()，將會產生一個通知。

    <?php
    $array     = [
    [    1, 2],
    [    3, 4],
    ];

    foreach (    $array as list($a, $b, $c)) {
    echo     "A: $a; B: $b; C: $c\n";
    }
    ?>

    上述範例將輸出：

    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:

    發現問題了嗎？

    了解如何改進此頁面 • 提交 Pull Request • 回報錯誤
    ＋新增備註

    使用者貢獻的備註 1 則備註

    39
    Okafor Chiagozie
    2 年前
    更簡單的解開巢狀陣列元素的方法

    $array = [
    [1, 2],
    [3, 4],
    ];

    foreach ($array as [$a, $b]) {
    echo "A: $a; B: $b\n";
    }
    ＋新增備註
    To Top