PHP迭代器接口使用方法详解

本文深入剖析了PHP中Iterator接口的强制实现规范与常见陷阱，强调必须完整实现current()、key()、next()、rewind()和valid()五个方法，缺一不可，并揭示foreach底层调用顺序（valid→current→key→next）及rewind被多次触发的关键事实；文章直击开发者高频踩坑点——如valid()返回false后current()/key()仍被调用、rewind未真正重置状态、key()因边界未校验而返回null等，同时对比Iterator与IteratorAggregate的适用场景，明确指出90%情况应优先选用更安全、更省心的IteratorAggregate，仅在需懒加载或遍历非数组结构时才手写Iterator，为PHP迭代器开发提供了兼具深度与实操性的权威指南。

Iterator 接口必须实现哪五个方法

PHP 的 Iterator 接口不是“能用就行”，而是强制要求实现全部五个方法，缺一不可，否则会报 Fatal error: Class ... must implement interface Iterator。这和 IteratorAggregate 不同——后者只用实现一个 getIterator()。

常见错误是只写了 current() 和 next()，结果运行时报错却找不到原因。

• current()：返回当前元素值（注意不是键）
• key()：返回当前元素的键（可以是字符串或整数）
• next()：将内部指针移到下一个位置（不返回值）
• rewind()：重置指针到第一个元素（必须可重复遍历）
• valid()：返回布尔值，表示当前是否处于有效位置（foreach 靠它判断是否继续）

foreach 里触发的是 valid() → current() → key() → next() 这个顺序

理解这个调用链，才能写出符合预期的迭代逻辑。比如很多人以为 rewind() 只在第一次进 foreach 时调，其实每次重新开始遍历（比如嵌套循环、多次 foreach 同一个对象）都会触发它。

典型坑点：valid() 返回 false 后，current() 和 key() 仍可能被调用——PHP 不保证跳过，所以这两个方法得能安全处理“越界”状态（比如返回 null 或抛异常）。

• 不要在 current() 里做副作用操作（如修改数据），它可能被反复调用
• rewind() 必须真正重置状态，不能只设个标志位就完事
• 如果底层数据源本身不可重置（比如数据库游标已关闭），Iterator 就不适合，该换 IteratorAggregate + ArrayIterator 缓存结果

Iterator vs IteratorAggregate 哪种更常用

90% 的场景下，你应该优先选 IteratorAggregate，而不是硬写 Iterator。前者只要返回一个现成的迭代器（比如 ArrayIterator、DirectoryIterator），不用操心指针逻辑；后者得自己维护状态机，极易出错。

只有两种情况才手写 Iterator：需要懒加载（比如逐行读大文件）、或封装非数组结构（如链表、树的深度遍历）。

• IteratorAggregate::getIterator() 必须返回实现了 Traversable 的对象，不能返回数组
• 返回 new ArrayIterator($this->data) 最省事，但要注意内存——大数组会全量加载
• 若需兼容 PHP 7.4+ 的只读数组，记得在 ArrayIterator 外包一层，避免写操作意外生效

foreach 中 key() 返回 null 是怎么回事

这不是 bug，是 key() 方法没正确实现。最常见原因是：在 rewind() 里没初始化索引变量，或在 valid() 返回 false 后，key() 仍直接返回未定义变量。

示例错误写法：

private $position = 0;
public function key() { return $this->data[$this->position]; }

——当 $this->position 超出范围，就返回 null 或触发 notice。

• 务必在 valid() 里检查边界，并确保 key() 和 current() 的行为与之严格一致
• 调试时可用 var_dump(iterator_to_array($obj)) 快速验证是否符合预期输出
• 注意：PHP 8.2+ 对 Iterator 实现加了更多运行时校验，以前能蒙混的逻辑现在会直接 fatal

实际写的时候，最容易漏掉的是 valid() 和 rewind() 的协同——它们共同决定了“这个对象到底能不能被反复 foreach”。状态没清干净，第二次遍历就静默失败。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP迭代器接口使用方法详解》文章吧，也可关注golang学习网公众号了解相关技术文章。