异常教程

PHP each() 函数（长文讲解）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言

在 PHP 开发中，数组的遍历是核心操作之一。each() 函数作为 PHP 内置的数组遍历工具，虽然在现代 PHP 中已逐渐被更简洁的 foreach 替代，但它依然在特定场景下（如旧代码维护或需要显式控制指针的场景）具有独特价值。本文将深入剖析 each() 函数的语法、工作原理、使用案例，以及与现代方法的对比，帮助开发者理解其底层逻辑并合理应用。

PHP each() 函数的基本语法与核心概念

1.1 函数语法与返回值

each() 函数的语法非常简洁：

mixed each ( array &$array )

该函数接受一个数组的引用（&$array），并返回一个包含当前元素 键 和 值 的关联数组，格式如下：

array(  
    0 => value, // 元素的值  
    1 => key,   // 元素的键  
    'key' => key,  
    'value' => value  
)

若数组指针到达末尾（即没有更多元素），则返回 FALSE。

比喻理解：
可以将数组想象为一本打开的书架，每个元素是书架上的书籍。each() 函数就像一只手指，每次调用时会指向当前书籍（返回键值），并自动移动到下一本书的位置。

1.2 内部指针的概念

PHP 数组具有“内部指针”特性，用于记录当前遍历的位置。调用 each() 时，指针会 自动向后移动一位。例如：

$array = ['a', 'b', 'c'];  
print_r(each($array)); // 输出第一个元素  
print_r(each($array)); // 输出第二个元素

若初始指针位于第一个元素，两次调用后指针将指向第三个元素。

关键点：

  • each() 的行为依赖于数组的内部指针状态。
  • 调用前需确保指针位于正确位置（如通过 reset() 重置）。

使用 each() 遍历数组的详细步骤

2.1 基础案例：遍历索引数组

以下示例展示如何用 each() 遍历索引数组：

$numbers = [10, 20, 30];  
reset($numbers); // 确保指针指向第一个元素  

while (false !== $current = each($numbers)) {  
    echo "键: {$current['key']}, 值: {$current['value']}\n";  
}

输出：

键: 0, 值: 10  
键: 1, 值: 20  
键: 2, 值: 30

2.2 关联数组的遍历

对于关联数组（键为字符串），each() 同样适用：

$user = [  
    'name' => 'Alice',  
    'age' => 25,  
    'email' => 'alice@example.com'  
];  

reset($user);  
while (false !== $entry = each($user)) {  
    echo "键: {$entry['key']}, 值: {$entry['value']}\n";  
}

输出将按键的顺序（PHP 7.3+ 保证插入顺序）展示所有键值对。

2.3 重置指针与错误处理

若未重置指针直接调用 each()，可能导致意外结果。例如：

$array = [1, 2, 3];  
each($array); // 第一次调用后指针移动到第二个元素  
each($array); // 第二次调用后指针移动到第三个元素  

// 此时若再次遍历，可能因指针过界而失败  
reset($array); // 必须手动重置指针

此外，需检查返回值是否为 FALSE，避免因空数组或指针越界引发错误。

each() 函数的注意事项与潜在问题

3.1 内部指针的副作用

each() 的核心特性——自动移动指针——也可能成为陷阱。例如：

$array = ['a', 'b', 'c'];  
// 场景1：正常遍历  
while ($current = each($array)) {  
    echo $current['value'];  
}  

// 场景2：尝试二次遍历（失败）  
while ($current = each($array)) {  
    echo $current['value']; // 永不执行，因指针已到末尾  
}

解决方案：

  • 在遍历前重置指针：reset($array)。
  • 避免在循环外部直接调用 each()，以免干扰后续逻辑。

3.2 与 foreach 的对比

foreach 是 PHP 推荐的数组遍历方式，其优势包括：

  • 无指针依赖：无需手动管理指针，代码更简洁。
  • 语法更直观：直接获取键值对，如 foreach ($array as $key => $value)。
  • 兼容性更好：each() 在 PHP 7.2 后被标记为弃用，而 foreach 是未来版本的主流选择。

示例对比：

// each() 写法  
reset($array);  
while ($entry = each($array)) {  
    echo $entry['key'] . ': ' . $entry['value'];  
}  

// foreach 写法  
foreach ($array as $key => $value) {  
    echo "$key: $value";  
}

3.3 多维数组的局限性

each() 不支持直接遍历多维数组。例如：

$multiArray = [  
    ['name' => 'Bob', 'age' => 30],  
    ['name' => 'Charlie', 'age' => 28]  
];  

reset($multiArray);  
while ($entry = each($multiArray)) {  
    echo $entry['value']['name']; // 正确，但需逐层处理  
}

对于多维结构，更推荐使用 foreach 的嵌套循环或递归方法。

each() 函数的实际应用场景与优化建议

4.1 旧代码维护与兼容性需求

在维护早期 PHP 项目（如 PHP 4/5 时代的遗留系统）时，each() 可能是唯一可用的遍历方式。例如：

// 假设代码需兼容 PHP 4  
$array = ['x', 'y', 'z'];  
while (list($key, $value) = each($array)) {  
    // 处理逻辑  
}

此时需注意，PHP 7.2 后 each() 被弃用，需逐步迁移代码。

4.2 需要显式控制指针的场景

当需要在遍历中灵活跳过某些元素或回退指针时，each() 的指针机制可能更直接。例如：

$array = [1, 2, 3, 4];  
reset($array);  
each($array); // 跳过第一个元素  
each($array); // 跳过第二个元素  

// 此时指针指向第三个元素  
echo current($array); // 输出 3

但需谨慎使用，避免代码可读性下降。

4.3 替代方案的对比与选择

方法优点缺点
each()显式控制指针，适合特定遗留场景需管理指针，PHP 7.2+ 被弃用
foreach简单直观，无副作用无法直接控制指针
array_iterator支持对象化操作，灵活控制指针语法复杂，适合高级场景

建议：

  • 新代码优先使用 foreach 或 array_iterator。
  • 旧代码维护时，可结合 each() 但逐步替换为现代语法。

常见问题解答与最佳实践

5.1 如何避免指针问题？

  • 始终重置指针：在调用 each() 前使用 reset()。
  • 单次遍历原则：避免在循环外调用 each()，防止干扰后续逻辑。
  • 使用临时数组：若需多次遍历，可复制数组副本：$tempArray = $originalArray。

5.2 如何结合其他函数优化？

each() 可与 list() 结合，简化代码：

$array = ['a', 'b', 'c'];  
reset($array);  
while (list($key, $value) = each($array)) {  
    echo "键: $key, 值: $value";  
}

此外，key() 和 current() 函数也可辅助查询当前指针位置。

5.3 在 PHP 7+ 中是否还能使用？

PHP 7.2 及更高版本中，each() 被标记为 弃用（但未移除），仍可运行。官方推荐逐步替换为 foreach。若需继续使用，需在代码注释中说明兼容性需求。

结论

each() 函数作为 PHP 数组遍历的底层工具，展现了对指针的精细控制能力，但其副作用和弃用状态也提示开发者谨慎使用。对于现代开发，foreach 是更安全、简洁的选择。然而，在特定场景（如旧代码维护或需显式指针操作时），each() 仍能发挥独特作用。理解其原理与限制，结合场景选择最优方案，是 PHP 开发者提升代码质量的关键。

通过本文的讲解与案例，读者应能掌握 each() 函数的核心逻辑，并在实际项目中做出合理决策。

最新发布

查看更多文章