PHP each() 替代方案：myEach() 实现与使用要点

each() 函数的背景与废弃

each() 函数在早期的 PHP 版本中扮演着重要的数组迭代角色。每次调用时，它会返回一个包含当前元素键值对的数组，并将数组的内部指针向前移动一位。其返回值结构通常包含四个元素：索引 0 存储键，索引 1 存储值，关联键 'key' 存储键，以及关联键 'value' 存储值。然而，由于其性能限制以及与现代 PHP 迭代器模型的不兼容性，each() 函数自 PHP 7.2 起被标记为废弃，并在 PHP 8.0 中被彻底移除。对于维护旧代码或学习旧教程的开发者来说，理解其行为并找到合适的替代方案至关重要。

自定义 myEach() 替代方案的分析

为了兼容那些依赖 each() 函数特定返回值的旧代码，开发者有时会选择实现一个自定义的替代函数。以下是一个常见的 myEach() 实现尝试：

初始实现（存在问题）

function myEach(&$array)
{
    $key = key($array); // 获取当前元素的键
    // 构造返回值，试图模拟 each() 的行为
    $result = ($key === null) ? false :
              [$key, current($array), 'key', 'value' => current($array)]; // 问题所在
    next($array); // 将数组内部指针向前移动一位
    return $result;
}

问题分析： 此实现试图模拟 each() 函数的返回值结构，即一个包含索引键值和关联键值（'key' => 键, 'value' => 值）的数组。然而，其中 ['key'] 这一部分是错误的。each() 函数的第三个元素（关联数组的键名为 'key' 的项）应该映射到实际的键值 $key，而不是一个字符串 'key' 本身。正确的结构应该是 'key' => $key。

正确的 myEach() 实现

为了完全模拟 each() 函数的行为，我们需要确保返回数组的结构与 each() 的原始输出完全一致。

function myEach(&$array)
{
    $key = key($array); // 获取当前元素的键
    if ($key === null) {
        return false; // 如果数组指针超出范围，返回 false
    }

    // 构造返回值，精确模拟 each() 的行为
    $result = [
        0       => $key,                 // 索引 0 存储键
        1       => current($array),      // 索引 1 存储值
        'key'   => $key,                 // 关联键 'key' 存储键的实际值
        'value' => current($array)       // 关联键 'value' 存储值的实际值
    ];
    next($array); // 将数组内部指针向前移动一位
    return $result;
}

实现说明： 在这个正确的实现中，'key' => $key 确保了返回数组的第三个元素是一个键名为 'key'，键值为当前元素实际键 $key 的关联项。这与 each() 函数的原始行为保持一致，从而能够更好地兼容那些严格依赖其返回结构的旧代码。函数首先通过 key() 获取当前指针位置的键，如果键为 null（表示已遍历完数组），则返回 false。否则，它构造一个包含索引和关联键值对的数组，并通过 next() 将数组内部指针向前移动。

使用 myEach() 的示例

以下是如何使用我们自定义的 myEach() 函数来迭代数组的示例：

$data = ['a' => 10, 'b' => 20, 'c' => 30];

// 在使用 myEach() 之前，可能需要重置数组指针，尤其是在多次迭代同一数组时
reset($data);

echo "使用 myEach() 迭代数组:\n";
while ($entry = myEach($data)) {
    echo "  通过关联键访问: Key = " . $entry['key'] . ", Value = " . $entry['value'] . "\n";
    echo "  通过索引键访问: Key = " . $entry[0] . ", Value = " . $entry[1] . "\n";
}

// 预期输出:
// 使用 myEach() 迭代数组:
//   通过关联键访问: Key = a, Value = 10
//   通过索引键访问: Key = a, Value = 10
//   通过关联键访问: Key = b, Value = 20
//   通过索引键访问: Key = b, Value = 20
//   通过关联键访问: Key = c, Value = 30
//   通过索引键访问: Key = c, Value = 30

注意事项与最佳实践

1. 优先使用 foreach: 对于绝大多数数组迭代场景，foreach 循环是 PHP 中最推荐和最有效的机制。它语法简洁，性能优异，并且不需要手动管理数组内部指针。在 PHP 7.0+ 版本中，foreach 的性能得到了显著优化，是现代 PHP 开发的首选。

   $data = ['a' => 10, 'b' => 20, 'c' => 30];
   echo "\n使用 foreach 迭代数组:\n";
   foreach ($data as $key => $value) {
       echo "  Key = " . $key . ", Value = " . $value . "\n";
   }

2. 自定义迭代器的必要性: 只有在极少数特定情况下，例如需要精确控制数组内部指针（如在循环中同时修改数组结构，或需要模拟 each() 的特定返回值格式以兼容旧代码）时，才考虑自定义 myEach() 这样的函数。

3. PHP 版本兼容性: each() 函数在 PHP 7.2 中被废弃，并在 PHP 8.0 中被彻底移除。因此，在 PHP 7.2 及更高版本中直接调用 each() 会导致致命错误。自定义替代方案对于旧代码的迁移尤其重要，但应视为临时过渡方案。

4. 性能考量: 自定义迭代函数可能会引入额外的函数调用开销，通常不如原生的 foreach 循环高效。在对性能有严格要求的场景下，应谨慎使用自定义迭代逻辑。

5. 替代 array_walk() 等高阶函数: 对于更复杂的数组操作，可以考虑使用 array_map(), array_filter(), array_reduce() 等高阶数组函数，它们通常更具表达力且效率更高。

总结

随着 PHP 版本的迭代，了解并适应函数废弃和移除是每个开发者必须面对的挑战。虽然 each() 函数已经成为历史，但通过正确理解其工作原理并实现兼容的替代方案，我们可以确保旧有代码的平稳过渡。然而，更推荐的做法是拥抱现代 PHP 的迭代器模型，优先使用 foreach 等更简洁、高效的语言结构。在确实需要模拟 each() 行为时，务必注意其返回值结构的细节，确保自定义实现的准确性，以避免潜在的运行时错误。