PHP迭代器必须实现current()、key()、next()、rewind()、valid()五个方法。current()返回当前值，key()返回当前键，next()移动指针，rewind()重置状态，valid()判断有效性。
PHP 迭代器必须实现哪些方法才能被 foreach 正常遍历
PHP 的 foreach 能遍历一个对象，前提是该对象实现了 Iterator 接口（或 Traversable，但后者是内置抽象接口，不能直接实现，必须通过实现 Iterator 或 IteratorAggregate 来满足）。只写个空类或只实现部分方法，foreach 会直接报错：Fatal error: Uncaught Exception: Objects returned by ...::getIterator() must be traversable 或更常见的 Object of class X could not be converted to string（当误用 echo $obj 时），但遍历失败的根本原因往往是接口契约没守全。
必须完整实现以下五个方法：
-
current()：返回当前元素的值（注意不是键） -
key()：返回当前元素的键（可以是整数或字符串；若不需要键，可返回null或0，但必须有返回值） -
next()：将内部指针移到下一个位置（不返回值，仅移动） -
rewind()：重置指针到第一个元素（通常要校验数据源是否为空，并设置初始状态） -
valid()：返回布尔值，表示当前指针是否指向有效元素（true才继续循环）
为什么 rewinding 失败会导致 foreach 只执行一次
常见错误是 rewind() 方法里没真正重置状态变量。比如你用一个私有属性 $position = 0 控制索引，但在 rewind() 中忘了设回 0，或没清空临时缓存导致 valid() 误判为 false。结果就是：第一次 foreach 走完后，第二次再遍历时，rewind() 没生效，valid() 直接返回 false，循环体一次都不进。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在
rewind()中显式重置所有状态变量（如$this->position = 0、$this->data = null等） - 在
valid()中不要依赖外部副作用，只基于当前$position和数据长度做判断，例如return isset($this->data[$this->position]);或return $this->position data); - 如果数据源是动态生成的（如数据库游标、文件流），
rewind()应能重新打开/重置资源，否则无法真正 rewind
IteratorAggregate 比 Iterator 更适合什么场景
当你已有现成数组、ArrayObject 或其他可遍历结构，又不想把遍历逻辑混进业务类里时，IteratorAggregate 是更轻量的选择。它只要求实现一个 getIterator() 方法，返回任意 Traversable 对象（比如直接 return new ArrayIterator($this->items)）。
对比差异：
-
Iterator：控制力强，可定制步进逻辑（如跳过空值、按需加载）、支持break/continue后恢复，但代码量大、易出错 -
IteratorAggregate：代码少、不易崩，适合封装已有数据；但无法干预单次迭代行为（比如不能在next()里加日志或限流） - 性能上无本质差别；但若
getIterator()每次都新建对象（如new ArrayIterator($this->items)），要注意内存开销——特别是大数组重复遍历时
调试迭代器最有效的三行 var_dump
别靠猜。在关键方法里加这三行，能立刻定位卡点：
public function valid() {
var_dump(__METHOD__, $this->position, $this->data);
return $this->position < count($this->data);
}
配合 foreach 执行过程看输出顺序：
- 先触发
rewind()→ 再反复调用valid()→current()→key()→next() - 如果
valid()第一次就返回false，说明rewind()没设好初始态 - 如果
valid()一直true但current()返回null，检查是不是$this->data没初始化，或键名对不上
真实项目里，最容易被忽略的是 valid() 的边界判断方式——用 isset() 还是 array_key_exists()，取决于你的键是否允许 null 值；而 count() 对非数组（如 stdClass）会静默返回 1，这种隐式转换坑过很多人。
