PHP 生成器 yield 后如何取 return 值

PHP 生成器里的 yield 和 return 不是同一条返回通道：yield 把一条条数据交给 foreach，return 则在生成器彻底结束后，使用 Generator::getReturn() 读取。最稳妥的写法是先保存生成器对象，完整迭代，再取最终结果。

官方文档：https://www.php.net/manual/en/generator.getreturn.php

yield 输出与 return 汇总是两条不同通道

把生成器想成一个可以暂停的生产线：每次执行到 yield，生产线把当前记录交给调用方，然后暂停；下一次继续时，它才会从暂停位置往下走。只有代码走到函数末尾或执行 return，生产线才算关闭。

下面的例子把导入记录逐条交给调用方，同时用 return 报告真正接收的数量。示例没有在文章中运行，输出值应以你的 PHP 版本和输入数据为准。

 101, 'name' => 'A'],
    ['name' => 'missing-id'],
    ['id' => 102, 'name' => 'B'],
]);

foreach ($generator as $row) {
    // 这里处理每条流式数据；最终统计值还没有在此处取出。
    echo $row['id'], PHP_EOL;
}

// foreach 结束后，生成器已经返回，才读取 return 值。
$accepted = $generator->getReturn();
echo 'accepted=', $accepted, PHP_EOL;

这里最容易混淆的是：$generator 不是数组，也不是函数直接返回的统计数字，而是一个实现了迭代器接口的对象。调用生成器函数时，函数体通常不会一次性跑完；foreach 消耗它，getReturn() 才读取最后那一个结果。

正确时机：让迭代器彻底结束后再取值

getReturn() 读取的是“已经计算完成的最终值”。如果生成器仍然有效，PHP 无法把“尚未算出”与“最终就是 null”区分开，因此提前调用会抛出异常。不要把它放在循环体里，也不要只调用一次 valid() 就把它当作完成信号。

如果业务结果允许是 0、空数组或空字符串，判断“是否拿到结果”时应使用严格比较或单独的完成状态。例如统计数量应写成 $accepted === 0 来判断零条，而不是 if (!$accepted)，后者会把合法的零误认为异常。

yield from 如何把子生成器的 return 传回来

当一个生成器组合另一个生成器时，yield from 会转发子生成器的可迭代值；子生成器结束时，它的 return 值可以被外层接住。这样适合把“逐条读取”和“局部统计”拆开，再由外层统一交付结果。

 $chunkCount, 'source' => 'chunk'];
}

$generator = readAll([['id' => 1], ['id' => 2]]);
foreach ($generator as $row) {
    echo $row['id'], PHP_EOL;
}

$summary = $generator->getReturn();
// 这里可安全读取 ['rows' => 2, 'source' => 'chunk']。
var_dump($summary);

这个结构有一个明确边界：只有外层生成器也结束后，最外层的 getReturn() 才能取到结果。若中途异常退出，先处理异常和资源清理，不要把尚未完成的汇总当成成功结果。

写入业务代码前的检查清单

• 需要逐条处理的内容放在 yield，需要最终汇总的内容放在 return。
• 把 Generator 对象保存到变量，不要直接在临时表达式上丢失引用。
• 在 foreach 完成后再调用 getReturn()，并为异常中断保留清晰的失败路径。
• 对 0、空数组和 null 做业务层面的严格判断。

常见问题

getReturn() 能在 foreach 循环内部调用吗？

不建议，也通常会抛出“生成器尚未返回”的异常。循环体执行时生成器仍可能有后续值，等循环自然结束后再调用。

没有写 return，getReturn() 会报错吗？

只要生成器已经结束，通常可以读取到 null。报错的关键不是有没有写 return，而是生成器是否已经完成执行。

yield 的最后一条值就是 return 值吗？

不是。最后一次 yield 仍属于数据流；return 是结束时的独立结果，必须通过 getReturn() 读取。