iterator接口必须实现current()、key()、next()、rewind()和valid()五个方法；少一个会导致foreach报致命错误，其中rewind()用于重置指针，valid()需真实判断有效性，推荐用iteratoraggregate分离遍历逻辑以提升可维护性。
Iterator 接口必须实现哪几个方法
PHP 的 Iterator 接口强制要求实现五个方法：current()、key()、next()、rewind() 和 valid()。少一个，foreach 就会报致命错误：Fatal error: Uncaught Exception: Objects returned by ...::getIterator() must implement Iterator。
常见错误是只写了 current() 和 next()，忘了 rewind() —— 这会导致第一次 foreach 正常，但第二次或嵌套遍历时直接失效。
-
rewind()必须重置内部指针（比如把索引设为 0 或重置游标对象） -
valid()判断当前是否还有有效元素，不能只写return $this->position data)—— 如果数据是动态生成或数据库游标，得靠真实状态判断 -
key()返回的类型要和实际使用场景一致；如果键是字符串 ID，别硬返回数字索引
用 IteratorAggregate 替代直接实现 Iterator 更稳妥
直接实现 Iterator 容易在状态管理上出错（比如 rewind() 没同步好 valid()）。更推荐让类实现 IteratorAggregate，把遍历逻辑拆到独立的迭代器类里。
这样做的好处是：主类专注数据结构，迭代器专注遍历规则，测试和复用都更方便。
- 主类只需实现
getIterator()，返回一个已封装好的迭代器实例 - 迭代器类可以复用，比如同一个
UserIterator可用于UserCollection和AdminUserList - 避免在业务类中混入指针操作逻辑，降低维护成本
示例：getIterator() 返回 new ArrayIterator($this->items) 是最简方案；若需自定义逻辑，则返回 new CustomUserIterator($this->users)。
遍历大数组或数据库结果集时注意内存和游标重置
用 Iterator 不等于自动流式处理。如果在 current() 中每次 SELECT * 全量加载，反而更耗内存。
真正起作用的是迭代器内部如何持有和推进数据源：
- 对数据库结果，应使用 PDOStatement 或 mysqli_result 的原生游标，配合
fetch()按需取一行，而不是把全部结果fetchAll()进内存 - 如果数据源不支持多次遍历（如已消耗的 PDOStatement），
rewind()就不能简单“重置指针”，而得重新执行查询或抛出异常 - PHP 8.1+ 支持
IteratorAggregate返回Generator，写法更轻量：yield from $this->db->query(...)
foreach 中 break 或异常后 Iterator 状态容易残留
foreach 中 break、return 或抛异常时，PHP 不会自动调用 rewind()，也不会清理迭代器状态。下次再遍历时，可能从上次中断的位置继续，也可能因状态不一致直接失败。
这不是 bug，而是设计使然 —— PHP 把状态管理完全交由开发者控制。
- 不要依赖“自动重置”，每次新遍历前显式调用
rewind()（尤其在单元测试中） - 如果迭代器封装了外部资源（如文件句柄、DB 连接），在
__destruct()中做清理，但注意：foreach中断不会触发析构 - 对不可重入的迭代器（比如单次消费的 API 流），应在
valid()中检查是否已耗尽，并在rewind()中明确 throwRuntimeException
真正麻烦的不是写接口，而是想清楚：这个迭代器该不该被反复使用？它的“重置”意味着什么？数据源是否允许多次读取？这些决定远比补全五个方法重要。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
