PHP foreach遍历对象报错的根本原因是未正确实现Iterator或IteratorAggregate接口，必须严格满足契约：Iterator需完整实现5个方法，IteratorAggregate只需返回Traversable对象，Generator适合按需生成但不可倒带。
别从“学迭代器”开始，直接解决你 foreach 报错或遍历不按预期的问题——PHP 迭代器不是语法糖，是契约，漏一个方法就 Fatal error。
为什么 foreach 某个对象会报 “Object of class X could not be converted to string”
这不是类型转换问题，是迭代失败的表象。PHP 在尝试遍历时发现类没实现任何迭代接口，内部 fallback 到 __toString()，结果又没定义，才抛这个误导性错误。
- 真正原因只有两种：
Class X must implement interface Iterator（漏方法）或getIterator() must return Traversable（返回了数组而非迭代器） -
foreach完全不看属性是否 public、不调用__get()或__isset()，只认Iterator或IteratorAggregate - 哪怕你只写了
current()和next()，漏了rewind()，也会在第二次foreach时静默跳过——因为指针没重置
IteratorAggregate 比手写 Iterator 更安全的场景
90% 的自定义集合类（比如封装了 $this->items 数组的 UserCollection）根本不需要自己维护 $position 状态变量。
- 只需实现
IteratorAggregate接口 +getIterator(): Traversable方法 - 返回
new ArrayIterator($this->items)，它已健壮处理键不连续、空值、count()等边界 - 常见翻车点：
return $this->items;—— 返回数组不是Traversable，直接报错 - PHP 8.1+ 注意返回类型必须写
Traversable，不能写死ArrayIterator，否则类型声明冲突
手写 Iterator 时 valid() 和 rewind() 容易错在哪
这两个方法出错，会导致遍历提前终止、重复第一项，或无限循环。
立即学习“PHP免费学习笔记（深入）”；
-
valid()别用isset($this->data[$this->position])：如果数组是[0 => 'a', 2 => 'c']，$this->position === 1时会误判为无效 - 推荐写法：
return $this->position >= 0 && $this->position data); -
rewind()必须真正重置状态变量，比如$this->position = 0;；只调用reset($this->data)不够，因为current()可能不依赖数组内部指针 - 如果数据源是动态的（如数据库游标），
rewind()得重新查询，不能只重置索引
Generator 是更轻量的替代方案吗
是，但适用场景明确：你要的是「按需生成值」，而不是「精确控制指针位置」。
- 用
yield写法，自动实现全部五个方法，不用手动管$position - 适合过滤、转换、分页拉取、大文件逐行读——例如
yield from $this->fetchPage($page) - 不适合需要
key()返回非递增整数、或需多次rewind()后保持状态的场景（Generator 无法倒带） - 注意：方法返回类型必须声明为
Traversable或Iterator，否则 IDE 和 PHPStan 会告警
最常被忽略的点：无论选哪种方式，foreach 能否工作，只取决于接口契约是否完整满足——不是“看起来像”，是每个方法签名、返回值、副作用都得对。写完立刻用两次 foreach 测试，比看十篇教程更管用。
