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 或抛异常）。
立即学习“PHP免费学习笔记（深入）”；
- 不要在
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”。状态没清干净，第二次遍历就静默失败。 
