PHP怎么使用生成器_yield关键字性能优化技巧【技巧】-php教程-PHP中文网

yield 是 php 的内存优化机制，用于将全量数据转为按需迭代流以避免 oom；return 仅传递元信息，不参与迭代；键名需统一类型防覆盖；yield from 保留被委托生成器键名；yield 本身非异步，不等价于 await。

php怎么使用生成器_yield关键字性能优化技巧【技巧】

yield 在 PHP 里不是语法糖，是内存开关

用 yield 不是为了“看起来高级”，而是为了把一个本该全量加载进内存的数组，变成按需吐出的迭代流。比如读取 100 万行 CSV、遍历深层嵌套目录、或处理分页 API 的全部结果——不用 yield，PHP 很可能直接 OOM；用了，内存稳定在几 MB。

常见错误现象：foreach 遍历时报 Fatal error: Allowed memory size exhausted，但函数本身没报错、也没明显大数组，问题就出在生成器被“转成数组”了：

function getIds() {
    for ($i = 0; $i

永远避免对大生成器调用 iterator_to_array()、array_values() 或 json_encode()（除非你确认数据量极小）
生成器返回的是 Generator 对象，它实现 Iterator，只能单向遍历一次，不可 rewind（除非用 Generator::getReturn() 后重调用）
PHP 7.0+ 才支持 yield from 委托，老版本得手动 foreach + yield

yield 和 return 的混用要小心返回值类型

PHP 7.0+ 允许生成器函数用 return 返回最终值，但它不会出现在 foreach 迭代中，而是通过 Generator::getReturn() 单独获取。很多人以为 return 'done' 会作为最后一项 yield 出来，结果发现遍历不到，还查不出错。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

function countToThree() {
    yield 1;
    yield 2;
    yield 3;
    return 'finished';
}
$gen = countToThree();
foreach ($gen as $val) {
    echo $val . "\n"; // 输出 1 2 3，没有 'finished'
}
echo $gen->getReturn(); // ✅ 输出 'finished'

return 值不参与迭代，只用于传递元信息（如总条数、状态码、摘要）
如果函数声明了返回类型（如 function foo(): Generator），return 后的值类型不影响类型声明，但 getReturn() 的类型无法静态推断
别在 yield 后写逻辑再 return——生成器一旦关闭，后续代码不执行

带键名的 yield 容易踩索引重复或类型隐式转换坑

写 yield $key => $value 时，PHP 会把非整型键转成字符串，而整型键若和已有键冲突，后 yield 的会覆盖前面的——这不是 bug，是迭代器规范行为，但常被当成“数据丢了”。

function badKeys() {
    yield 0 => 'a';
    yield '0' => 'b'; // 覆盖了上一条！因为 '0' == 0 在数组键比较中为 true
    yield 'foo' => 'c';
    yield 1 => 'd';
}
// 实际只产出：'0'=>'b', 'foo'=>'c', 1=>'d'

键名尽量统一类型：全用字符串，或全用整数；混合使用前先 var_dump(array_keys(iterator_to_array($gen))) 看一眼（仅调试小数据）
如果依赖顺序且需要自定义键，不如直接 yield 数组：yield ['id' => $id, 'name' => $name]，更可控
用 yield from 委托另一个生成器时，被委托生成器的键名照常生效，不会自动重编号

协程场景下 yield 不等于 await，别指望它自动调度

PHP 8.1+ 的 Fiber 和第三方库（如 amphp）才真正支持异步协作式调度。yield 本身只是暂停/恢复生成器执行，不涉及 I/O 等待、事件循环或线程切换。有人看到 Swoole 或 Laravel Octane 文档里有 yield，就以为能替代 await，结果协程卡死或并发没提升。