PHP生成器与迭代器应用解析

本文深入剖析了PHP生成器（Generator）与手动实现Iterator接口的核心差异与适用边界：生成器是单向、不可重置的轻量级迭代方案，天生节省内存（如逐行读取大文件仅占几MB），但调用rewind()会直接崩溃，需多次使用时必须重新创建实例；而手写Iterator类则提供 rewind()、seek()、多实例隔离等灵活控制能力，适合需要双向遍历、状态复用或复杂协议的场景；同时澄清了yield from的委托本质与return在生成器中返回元信息而非函数值的关键特性，帮助开发者根据内存效率、控制粒度和维护成本做出精准技术选型。

Generator对象为什么不能调用rewind()

因为生成器是只向前迭代器，内部状态不可重置。一旦开始遍历，Generator::rewind() 会直接抛出 Fatal error: Uncaught Exception: Cannot rewind a generator。这不是 bug，而是设计使然——生成器的执行流是单向、不可回溯的，每次 yield 后函数挂起，恢复时只能继续向下走。

常见错误现象：foreach 遍历完再调用 $gen->rewind() 或重复 foreach，结果崩溃；或误以为生成器像数组一样可多次遍历。

• 若需多次使用，必须重新调用生成器函数（如 fileGenerator('log.txt')）获得新 Generator 实例
• 不要在生成器函数里写 rewind() 相关逻辑，PHP 不支持
• 想模拟“可重置”，得自己缓存结果（但违背生成器节省内存的初衷）

yield 和手动实现 Iterator 接口的性能差异在哪

核心差异不在“快慢”，而在“内存占用”和“代码维护成本”。生成器每次只产出一个值并暂停，状态保存在 C 层协程栈中；而手写迭代器类（如 class MyIterator implements Iterator）需自己管理全部状态变量（$position, $items 等），且容易因逻辑错误导致 valid() 判定失效、死循环或越界。

性能影响示例：读取 500MB 日志文件

• 手写迭代器：若把整文件 file($path) 加载进 $this->lines 数组，内存立刻暴涨至 600MB+，大概率 Fatal error: Allowed memory size exhausted
• 生成器：逐行 fgets()，内存稳定在几 MB，yield $line 后立即释放上一行引用
• 但注意：生成器每次调用 next() 有轻微协程切换开销，对百万级小数组遍历，手写迭代器可能略快 5%~10%，不过这几乎无实际意义

什么时候必须用手写 Iterator 类，而不是生成器

当需要双向控制、复用状态、或自定义迭代协议时，生成器不够用。生成器本质是“单向、一次性、函数式”的；而迭代器类可以暴露更多可控接口。

典型场景：

• 需要 rewind()、seek($pos)（比如分页器跳转到第 N 页）
• 多个迭代器同时遍历同一数据源且状态隔离（如两个 foreach 并行处理同一数据库结果集）
• 要实现 IteratorAggregate，把迭代逻辑委托给内部不同策略（如按时间倒序 / 按热度排序）
• 需在 current() 中做复杂计算（如实时聚合），且该计算依赖外部传入参数（生成器函数参数固定，无法动态注入）

一句话：生成器解决“怎么省内存地吐数据”，迭代器类解决“怎么灵活地管数据怎么被吐”。

yield from 和 return 在生成器里的实际作用

yield from 不是语法糖，它是生成器委托机制——把当前生成器的控制权临时交给另一个可遍历对象，并自动展开其值；return（PHP 7+）则用于在生成器结束时返回一个最终值，可通过 $gen->getReturn() 获取。

容易踩的坑：

• yield from [1, 2, 3] 等价于 yield 1; yield 2; yield 3;，但若右边是另一个生成器，它会真正复用其执行上下文，不是简单复制值
• return 'done' 必须出现在所有 yield 之后，否则会提前终止；且 return 后不能再 yield
• getReturn() 只能在生成器彻底结束后调用（valid() === false），否则抛 Exception: Cannot get return value of a generator that hasn't returned
• 别用 yield from 委托大数组（如 yield from range(1, 1000000)），它仍会把整个数组加载进内存

最常被忽略的一点：生成器函数本身没有返回值（调用后永远得到 Generator 对象），return 的值是附加在生成器对象上的元信息，不是函数返回值——这点和普通函数完全不同。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~