PHP 生成器如何双向传值并接收最终返回值

我第一次把 PHP 生成器用于分段解析时，只把它当成“省内存的迭代器”。后来需要让调用方根据当前产出回传一个确认值，才发现 yield 本身还是一个表达式：生成器可以先向外给值并暂停，调用方再用 Generator::send() 把数据送回这个暂停点。等生成器真正结束后，函数里的 return 还能通过 getReturn() 单独取出。

send($value) 返回的是恢复执行后遇到的下一次 yield 值；getReturn() 取得的才是生成器结束时的最终 return 值。

这套双向传值解决什么问题

普通 foreach 适合“生成器持续产出、调用方持续消费”的单向场景。双向生成器更适合需要反馈的同步协议，例如解析器先报告“已准备”，调用方再发送一段数据；校验器给出当前计数，调用方再决定提交下一项；或者测试桩产出请求，再接收测试代码注入的响应。

它仍然是同步执行：同一时刻只有调用方或生成器一侧在运行。yield 暂停函数并保存局部状态，send() 恢复它，而不是创建线程、Promise 或后台任务。

支持范围与三个核心语义

Generator::send() 从 PHP 5.5 起可用，Generator::getReturn() 从 PHP 7 起可用。准备使用前先记住三个语义：

• current() 会让尚未启动的生成器运行到第一个 yield，并读取该值。
• send($value) 把参数作为当前 yield 表达式的结果，然后继续执行，直到下一次 yield 或函数结束。
• getReturn() 只能在生成器执行结束后读取；还没结束就调用，会抛出异常。

PHP 的 send() 还有一个方便之处：生成器尚未到达第一个 yield 时，它会先自动前进到第一个暂停点，再注入数据，因此不要求像某些语言那样先额外“预热”。不过在教学和业务代码中，我仍倾向先调用 current()，因为这样能明确看见协议的第一条输出。

最小示例：发送一次数据，再接收最终结果

current(), PHP_EOL;          // ready

// 把 task-42 送回上面的 yield，同时接收下一次 yield。
echo $channel->send('task-42'), PHP_EOL;    // accepted:task-42

// 越过第二个 yield，让函数执行到 return。
$channel->next();

// 只有结束后才读取最终返回值。
if (!$channel->valid()) {
    echo $channel->getReturn(), PHP_EOL;    // closed:task-42
}

这段代码里有两条不同的“返回通道”。yield 'ready' 和第二个 yield 是会话中的中间消息；return "closed:..." 是整段生成器函数的最终结果。把两者混在一起，是初次使用时最常见的误解。

多轮 send：用显式游标驱动会话

需要多轮交互时，我会用 while、current()、send() 和 valid() 明确控制游标，而不是在普通 foreach 循环体里随意调用 send()。原因是 send() 本身已经会恢复生成器并移动到下一个暂停点，foreach 下一轮又会推进一次，容易出现看似“跳过一项”的结果。

current(), PHP_EOL;     // 0
echo $collector->send('alpha'), PHP_EOL; // 1
echo $collector->send('beta'), PHP_EOL;  // 2

// 发送结束信号后，生成器执行 return 并关闭。
$collector->send(null);

if (!$collector->valid()) {
    var_export($collector->getReturn()); // ['alpha', 'beta']
}

这里把 null 定义成协议级结束信号，因此业务数据如果本身允许 null，就应改用枚举、专用对象或带类型的消息结构，避免值域冲突。生成器不是网络协议框架，结束条件和错误格式都需要调用方自己约定。

yield from 如何接住子生成器的 return

yield from 会把子生成器产出的值继续向外委托；当子生成器结束时，它的 return 又会成为整个 yield from 表达式的结果。这样可以把一段长会话拆成多个小生成器，同时让外层汇总最终状态。

 $childResult, 'status' => 'done'];
}

$channel = parentChannel();
echo $channel->current(), PHP_EOL;       // child-ready
echo $channel->send('php'), PHP_EOL;     // child-result:PHP
$channel->next();

if (!$channel->valid()) {
    var_export($channel->getReturn());
}

兼容处理与错误边界

性能与安全注意

生成器的优势是按需推进并保留少量局部状态，适合流式数据和有限状态会话；它不会自动让 CPU 任务并行，也不会替你提供超时、取消、鉴权和输入清洗。外部输入通过 send() 进入函数体后，仍要像普通参数一样做类型检查、长度限制和业务校验。

还要避免让调用方依赖过于隐蔽的暂停点。每增加或删除一个 yield，会话协议就可能改变。如果这是跨模块公共能力，最好把中间消息和最终结果定义成明确的数据对象，并为每轮输入输出写单元测试，而不是只靠字符串约定。

常见问题

send() 能直接拿到 return 值吗？

不能把两者等同。send() 返回恢复后遇到的下一次 yield 值；如果生成器直接结束，它不会替代 getReturn()。最终结果仍应在结束后单独读取。

为什么 getReturn() 报生成器尚未返回？

通常是仍停在某个 yield。先继续调用 next() 或 send() 让函数走到 return，再确认 valid() 为 false。不要用捕获异常来代替状态判断。

双向生成器适合替代协程框架吗？

不适合。它很适合表达同步的暂停、恢复和反馈，但不自带事件循环、并发调度或异步 I/O。需要真正的并发和取消语义时，应选择对应的异步库、Fiber 调度器或队列系统。

把整套机制压缩成一句话就是：current() 读取当前产出，send() 把值送回暂停点并取得下一次产出，valid() 判断是否结束，最后用 getReturn() 读取函数级结果。只要把中间 yield 和最终 return 分开理解，双向生成器就会从“神秘语法”变成一个可控的同步会话工具。