如何替代已弃用的 each() 函数：现代 PHP 数组遍历最佳实践-php教程-PHP中文网

如何替代已弃用的 each() 函数：现代 PHP 数组遍历最佳实践

PHP 7.2+ 中 each() 函数已被废弃并移除，推荐使用 foreach 替代；本文详解如何安全迁移旧代码，包括单次取值、多次迭代及兼容性注意事项。

php 7.2+ 中 `each()` 函数已被废弃并移除，推荐使用 `foreach` 替代；本文详解如何安全迁移旧代码，包括单次取值、多次迭代及兼容性注意事项。

在 PHP 开发中，each() 函数曾常用于获取数组当前键值对并推进内部指针（例如 list($k, $v) = each($arr)）。但自 PHP 7.2.0 起，该函数被正式标记为 deprecated，并在 PHP 8.0+ 中完全移除。若你遇到类似错误：

Deprecated: Function each() is deprecated in /path/to/script.php on line X

说明你的代码仍在调用该函数，需立即升级。

✅ 推荐替代方案：`foreach`（最常用且语义清晰）

对于大多数场景（尤其是遍历整个数组），直接改用 foreach 是最简洁、高效且可读性强的方式：

<?php $files = ['index.php' => 1240, 'style.css' => 3560, 'script.js' => 8920];

// ❌ 已废弃（PHP 7.2+ 报错）
// list($k, $v) = each($files);

// ✅ 推荐：标准 foreach 遍历
foreach ($files as $k => $v) {
    echo "File: $k → Size: $v bytes\n";
}
// 输出：
// File: index.php → Size: 1240 bytes
// File: style.css → Size: 3560 bytes
// File: script.js → Size: 8920 bytes

? foreach 自 PHP 4 起即已支持，兼容性极佳，且自动重置并管理内部数组指针，无需手动干预。

btpanel phpsite 宝塔面板PHP网站
宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

⚠️ 特殊场景：仅需获取「首个」键值对（模拟 `each()` 的单次行为）

若原逻辑仅依赖 each() 取第一个元素（如初始化、条件判断），可用 key()/current() 组合替代：

<?php $files = ['index.php' => 1240, 'style.css' => 3560];

// ❌ 不再安全
// list($firstKey, $firstVal) = each($files); // deprecated

// ✅ 安全替代（不修改原数组指针）
$firstKey = key($files);
$firstVal = current($files);

echo "First: $firstKey = $firstVal"; // First: index.php = 1240

⚠️ 注意：key() + current() 不会移动指针，行为与 each() 的「首次调用」一致；若需模拟 each() 的「逐次推进」效果（如循环中多次调用 each()），则必须改用 foreach 或显式 next() + key()/current()，但强烈不建议——这违背现代 PHP 的设计哲学，易出错且难以维护。