
PHP 8.1 已完全移除 each() 函数,原依赖其遍历数组并自动推进内部指针的代码(如 while(list() = each()))需改用 foreach 替代,以确保兼容性、可读性与执行安全。
php 8.1 已完全移除 `each()` 函数,原依赖其遍历数组并自动推进内部指针的代码(如 `while(list() = each())`)需改用 `foreach` 替代,以确保兼容性、可读性与执行安全。
在从 PHP 7.4 升级至 PHP 8.1 的过程中,each() 函数的彻底移除是一个关键兼容性断点。该函数曾常用于配合 list() 实现手动数组遍历,例如:
// ❌ PHP 7.4 可用,PHP 8.0+ 已废弃/报错(Fatal error in 8.1)
while (list($tmpkey, $tmpval) = each($menu_array)) {
echo "Key: $tmpkey → Value: $tmpval<br>";
}你尝试的手动模拟方式:
// ❌ 错误:未手动移动内部指针,导致无限循环
while (list($tmpkey, $tmpval) = [key($menu_array), current($menu_array)]) {
// ... 处理逻辑
next($menu_array); // ⚠️ 若遗漏此行,key()/current() 始终返回首元素
}虽然理论上可通过 key() + current() + next() 组合模拟 each() 行为,但极易出错——尤其在循环体中存在 continue、异常或提前 break 时,next() 调用可能被跳过,从而引发死循环(正如你所遇问题)。此外,该写法语义模糊、可维护性差,且违背 PHP 遍历的最佳实践。
✅ 推荐方案:直接使用 foreach
foreach 是 PHP 官方推荐、语义清晰、性能优异且完全安全的替代方式。它天然支持键值对遍历,无需手动管理数组指针,也完全规避了无限循环风险:
立即学习“PHP免费学习笔记(深入)”;
// ✅ 推荐:简洁、安全、符合现代 PHP 风格
foreach ($menu_array as $tmpkey => $tmpval) {
// 此处 $tmpkey 和 $tmpval 与原 each() 行为完全一致
echo "Key: $tmpkey → Value: $tmpval<br>";
// 其他菜单渲染逻辑(如生成 <li>、判断 active 状态等)
}? 补充说明:foreach 在遍历时会隐式复制数组(对于小到中等规模数组影响可忽略),且其行为在 PHP 7.0+ 后已高度优化,性能与手动指针操作基本持平;若需原地修改数组值,可使用引用语法:foreach ($menu_array as &$tmpval)(注意循环后 unset($tmpval) 避免意外引用残留)。
? 迁移注意事项总结:
- 彻底删除所有 each() 调用,不要尝试“打补丁式”模拟;
- foreach 自动重置数组内部指针,无需担心多次遍历冲突;
- 若原逻辑依赖 each() 返回 false 终止循环(如空数组),foreach 天然处理(空数组不进入循环体);
- 检查所有使用 reset()/next()/key()/current() 的上下文,确认是否仍有必要——多数场景 foreach 已覆盖全部需求。
升级不是妥协,而是拥抱更健壮、更清晰的代码范式。将 each() 替换为 foreach,既是解决 PHP 8.1 兼容性的必经之路,也是提升代码长期可维护性的明智之选。










