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); // 打破与最后一个元素的引用
    ?>

    警告

    即使在 foreach 循环之后，$value 的引用和最后一个数组元素仍然存在。 建议使用 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 示例 1：仅值 */

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

    foreach (    $a as $v) {
    echo     "当前 \$a 的值：$v.\n";
    }

    /* foreach 示例 2：值（以及用于说明的其手动访问表示法） */

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

    $i = 0; /* 仅供说明之用 */

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

    /* foreach 示例 3：键和值 */

    $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：动态数组 */

    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:

    改进此页面

    了解如何改进此页面 • 提交拉取请求 • 报告错误
    ＋添加笔记

    用户贡献笔记 2 notes

    27
    Okafor Chiagozie
    1 year ago
    解包嵌套数组元素的更简单方法

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

    foreach ($array as [$a, $b]) {
    echo "A: $a; B: $b\n";
    }
    -9
    Sanusi Hassan
    1 year ago
    解构数组元素

    你可以使用以下方法解包嵌套数组元素

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

    foreach (    $array as $v) {
    [    $a, $b] = $v;
    echo     "A: $a; B: $b\n";
    }
    ?>
    ＋添加笔记
    To Top