PHP中对象支持foreach必须实现Iterator或IteratorAggregate接口：前者需实现current、key、next、rewind、valid五个方法；后者只需getIterator()返回ArrayIterator等迭代器实例，更简洁高效。
PHP中让对象支持foreach必须实现Iterator接口
PHP不会自动把普通对象变成可迭代结构，直接对未实现迭代接口的对象用foreach会报致命错误：Fatal error: Uncaught Error: Cannot use object as array或更明确的Object of class X could not be converted to string（当内部尝试转字符串时）。这不是语法问题，是类型契约缺失。
核心就一条：想用foreach遍历对象，必须显式实现Iterator接口——它强制你提供current()、key()、next()、rewind()、valid()这五个方法。少一个，foreach就拒绝合作。
-
Iterator是面向“外部控制流”的接口：每次foreach走一步，都调用对应方法，由你决定返回什么、移到哪、是否结束 - 别试图只实现
__get()或__isset()来“模拟”迭代——没用，foreach根本不看它们 - 如果只是想把对象属性当数组遍历，且属性全为public，
IteratorAggregate配合ArrayIterator更省事（见下节）
用IteratorAggregate替代手写全部五个方法
多数场景下，你要迭代的其实是对象内部某个数组（比如$this->data），没必要重造轮子写五条逻辑。这时IteratorAggregate是更安全、更不易出错的选择：它只要求实现一个getIterator()方法，返回一个已有的迭代器实例。
常见错误是返回普通数组——return $this->data;不行，foreach要的是迭代器对象，不是数组值。
立即学习“PHP免费学习笔记（深入）”；
- 正确做法：
return new ArrayIterator($this->data); - 若需键值对保持原样，且
$this->data是关联数组，ArrayIterator天然支持；若只是索引数组，也一样可用 - 别用
return new IteratorIterator(new ArrayIterator(...))——多套一层没意义，还可能干扰key()行为 - 注意
ArrayIterator本身可修改（append()、offsetSet()等），如需只读，考虑ArrayObject::ARRAY_AS_PROPS或封装一层
Iterator和IteratorAggregate的性能与兼容性差异
两者在PHP 5.0+全版本都可用，无兼容性门槛。但行为差异会影响调试体验和运行效率。
手写Iterator接口时，foreach每轮调用5次方法（valid→current→key→next），而IteratorAggregate只调一次getIterator()，后续全由ArrayIterator内部C实现处理，实际更快，尤其数据量大时。
- 手写
Iterator适合需要精细控制迭代状态的场景，比如分页游标、懒加载数据库记录、跳过某些条件项 -
IteratorAggregate适合“数据已存在，只是换个方式暴露”，代码少、bug少、维护成本低 - 两者都不能被
count()直接调用——除非额外实现Countable接口，否则count($obj)会报Warning: count(): Parameter must be an array or an object that implements Countable
容易被忽略的边界情况：rewind()和valid()的配合
很多手写Iterator的人只关注current()和next()，却忘了foreach启动前必先调rewind()，每次循环开头必查valid()。这两个方法不配对，foreach可能无限循环或直接跳过。
典型翻车现场：rewind()里没重置指针（比如$this->position = 0;），或valid()里用isset($this->data[$this->position])但数组键不连续，导致valid()提前返回false，循环戛然而止。
-
rewind()必须确保下次valid()能返回true（如果是空数据，则valid()应立刻返回false） -
valid()不能只判断$this->position data)——如果$this->data是稀疏数组，得用array_key_exists()或isset()配合键检查 - 调试时加
echo "rewind\n";或var_dump(__METHOD__);能快速定位是否被调用、何时中断
