PHP 8.4未修改Iterator接口方法，但默认启用JIT和强化类型检查，要求current()/key()显式标注返回类型，推荐用IteratorAggregate+yield实现，避免手写五方法及滥用装饰器迭代器。
PHP 8.4 中 Iterator 接口没变，但要注意 JIT 和类型系统对遍历行为的影响
PHP 8.4 并未修改 Iterator 或 Traversable 的底层契约——你依然要实现 current()、key()、next()、rewind() 和 valid() 这五个方法。但 PHP 8.4 默认启用 Opcache.JIT=1255，且强化了联合类型与只读类检查，如果迭代器返回值类型和声明不一致（比如 current(): string 却返回 null），会直接触发 TypeError 而非静默转换。
实操建议：
- 在
current()和key()方法上显式标注返回类型，例如public function current(): mixed（若不确定具体类型）或public function current(): int|string - 避免在
rewind()中执行耗时操作（如数据库重连），JIT 会内联简单方法，但无法优化阻塞逻辑 - 如果集合底层是只读数组（
array），优先用ArrayIterator而非手写——它已针对 PHP 8.4 的类型推导做了适配
用 IteratorAggregate 配合生成器（yield）是最简可行方案
比起硬写五个方法，PHP 8.4 更推荐让类实现 IteratorAggregate，然后在 getIterator() 中返回一个 Generator。生成器天然满足 Iterator 接口，且 PHP 8.4 对 yield 的内存优化更激进（延迟分配，避免中间数组）。
示例：一个带过滤的用户集合
立即学习“PHP免费学习笔记（深入）”；
class UserCollection implements IteratorAggregate
{
private array $users;
public function __construct(array $users) {
$this->users = $users;
}
public function getIterator(): Traversable
{
foreach ($this->users as $user) {
if (isset($user['active']) && $user['active']) {
yield $user; // PHP 8.4 会自动包装为 Generator 对象
}
}
}
}
// 使用
foreach (new UserCollection($data) as $user) {
echo $user['name'];
}
注意：yield 在 PHP 8.4 中仍不支持在表达式上下文中直接使用（如 array_map(fn() => yield ..., $arr)），必须放在函数/方法体内。
IteratorIterator 和 LimiterIterator 在 PHP 8.4 里能链式调用但别滥用
PHP 标准库的装饰器迭代器（如 IteratorIterator、LimiterIterator、CachingIterator）在 PHP 8.4 中完全可用，且类型提示更严格。但它们会增加对象层级和虚函数调用开销——JIT 不会内联这些包装器。
常见误用场景：
- 对小数组（foreach 慢 2–3 倍
- 用
CachingIterator::CALL_TOSTRING但元素没有定义__toString()：PHP 8.4 会抛Fatal error，而非返回空字符串 -
LimiterIterator的$offset和$limit传负数：PHP 8.4 不再静默修正，直接报ValueError
替代思路：用 array_slice() 预处理数据，再交给简单迭代器——PHP 8.4 的 array_slice() 已深度优化，比 LimiterIterator 快且语义清晰。
自定义迭代器遇到 Fatal error: Uncaught ValueError 怎么快速定位
PHP 8.4 对迭代器协议校验更严，典型错误是 valid() 返回 false 后，current() 或 key() 仍被调用（某些 foreach 编译路径会触发）。此时会抛 ValueError，但堆栈不显示具体哪行出问题。
调试技巧：
- 在
current()开头加if (!$this->valid()) { throw new RuntimeException('current() called when invalid'); } - 用
debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 1)快速看上层是否来自foreach内部（返回['function' => 'unknown']表示是 VM 级调用） - 禁用 JIT 临时验证：
php -d opcache.jit_buffer_size=0 script.php——如果错误消失，说明是 JIT 对迭代器状态跟踪的边界 case
最易被忽略的是：PHP 8.4 中 Iterator 实现类如果声明了 final，但内部又依赖子类覆盖方法（比如抽象基类模板），会导致运行时协议断裂——这种设计在 8.3 可能侥幸通过，8.4 会直接拒绝加载。
