PHP Generator 的 yield from 为什么会吞掉返回值：迭代器委托与 getReturn 边界

写一个逐条读取 CSV 的导入器时，最容易误判的是：外层循环明明拿到了所有记录，却看不到子 Generator 最后的统计值。yield from 委托的是遍历过程，外层拿到的是子 Generator 产出的每个值；子 Generator 的 return 值不会自动混进循环结果，必须等委托完成后调用 getReturn()。

yield from 负责把值和发送过程交给子 Generator，getReturn() 负责在迭代结束后取回它的最终返回值；两者解决的是不同阶段的问题。

先看清 yield from 交接了什么

下面的例子把批量导入拆成两层：rows() 只负责产出记录并在末尾返回计数，importRows() 用 yield from 把记录转发给调用方。代码里的三个稳定节点是 Generator、yield from 和 getReturn，后面的配图只解释它们之间的真实调用链。

 101], ['id' => 102]] as $row) {
        $count++;
        yield $row;
    }
    return $count;
}

function importRows(): Generator
{
    $result = yield from rows();
    return $result;
}

$stream = importRows();
foreach ($stream as $row) {
    echo $row['id'], PHP_EOL;
}
echo 'count=', $stream->getReturn(), PHP_EOL;

循环输出的是 101 和 102，最后的 count=2 来自 getReturn()。如果把 return $result 误写成普通 yield $result，统计值就会变成第三条遍历数据，调用方也无法区分它和真实记录。

调用链为什么必须等到迭代完成

getReturn() 不是“读取当前值”的快捷方法，而是读取 Generator 已经执行完毕的 return。创建 $stream 时，函数体还没有真正执行；第一次 valid() 或 foreach 才会推动它运行。这个顺序决定了哪些检查可以通过。

valid()) {
    $row = $stream->current();
    echo $row['id'], PHP_EOL;
}

foreach ($stream as $row) {
    // 继续消费剩余记录
}

echo $stream->getReturn(), PHP_EOL;

这里先通过 valid() 确认有值，再用 current() 读取当前记录；foreach 消费到结束后，才读取 getReturn()。把最后一行提前，会得到“Cannot get return value of a generator that hasn't returned”的运行时错误。

线上处理时的三个检查点

检查点一：不要把 return 当成 yield

yield 会暂停函数并产生一个可遍历值；return 会结束 Generator。需要把汇总信息交给上层时，用 return，并让上层保存 yield from 的表达式结果。

检查点二：异常会截断返回值路径

如果子 Generator 在最后一个 yield 后抛出异常，它没有正常执行到 return，外层不应把它当成“计数为零”。调用方要在消费循环外捕获异常，并把导入状态标记为失败。

检查点三：一次 Generator 只能沿一个方向消费

Generator 不是数组。把它消费完后，不能再次 rewind；如果业务既要逐条处理又要保留统计结果，就在一次消费过程中记录必要状态，或者让子 Generator 明确返回一个小而稳定的结果。

一个可复查的最小运行方式

把代码保存为 yield-from.php 后执行 php yield-from.php，应看到两条记录和一条计数。复查时重点看顺序：记录先出现，计数最后出现；若没有计数，先检查 foreach 是否真的把 Generator 消费到结束。

相关问答

yield from 可以委托普通数组吗？

可以，数组会被遍历并转发键和值，但数组没有 Generator 的 return 结果；只有委托的 Generator 正常返回时，外层才有可读取的返回值。

getReturn 能在 foreach 中途调用吗？

不能把它当作中途统计接口。中途调用时 Generator 尚未返回，应该在循环结束或确认 valid() 为 false 后再读取。

为什么推荐让外层保存 yield from 的结果？

因为这个结果正是子 Generator 的 return 值。保存到 $result 后再 return，调用链的职责清楚，后续增加校验或日志也不容易把统计值误当成数据行。

小结

排查 PHP Generator 时，把“当前产出的值”和“函数最终返回值”分开看：yield from 解决前者的转发，getReturn() 解决后者的回收。只要保证 Generator 正常结束，再读取返回值，嵌套迭代就不会变成一团难追的隐式状态。