PHP Fiber::suspend 恢复值怎么在嵌套函数中传递

PHP Fiber 里最容易混淆的是“挂起时拿到的值”和“Fiber 最后返回的值”。如果 Fiber::suspend() 写在嵌套函数中，Fiber::resume($value) 传入的值会回到那一次 suspend() 调用，嵌套函数可以像接收普通返回值一样继续执行；但 start() 或 resume() 拿到的是下一次挂起时对外交出的值，Fiber 结束后的业务结果要用 getReturn() 取。

先分清三种值分别从哪里来

可以把一次 Fiber 交互看成两个方向：Fiber 用 suspend($value) 把消息交给外部，外部用 resume($value) 把消息送回 Fiber。恢复后，suspend() 表达式本身就会得到这个恢复值。

因此，不要把 resume() 的返回值当成“被恢复的函数最终结果”。它代表这次切换后 Fiber 对外发出的下一个挂起值；只有确认 isTerminated() 后，才读取 getReturn()。

嵌套函数如何接住 resume 传回来的值

下面的示例把挂起点放进 waitForApproval()，外层的 loadConfig() 不需要知道 Fiber 的控制方法。它只接收普通的字符串返回值，这正是 Fiber 与 Generator 在调用栈上的重要区别。

start();
// $message === 'need-approval'

$afterResume = $fiber->resume('approved');
// Fiber 已结束时，$afterResume 通常为 null。
$result = $fiber->getReturn();
// $result === 'config:approved'

echo $message, PHP_EOL, $result, PHP_EOL;
?>

执行顺序是：start() 进入闭包，闭包调用 loadConfig()，再进入 waitForApproval()；深层的 suspend() 让整个 Fiber 栈暂停，并把 need-approval 交给外部。随后 resume('approved') 让程序从原来的挂起点继续，所以 $value 得到 approved，结果再逐层返回。

多次挂起和异常恢复要看当前状态

一个 Fiber 可以重复挂起，但每一次 resume() 都必须对应一个处于 suspended 状态的 Fiber。连续调用 resume()，或者在尚未挂起时调用，都会触发 FiberError。调度器通常按 isSuspended()、isTerminated() 做状态分支。

start();

if ($fiber->isSuspended()) {
    $two = $fiber->resume('accepted');
}

if ($fiber->isSuspended()) {
    $fiber->resume('confirmed');
}

if ($fiber->isTerminated()) {
    echo $fiber->getReturn(), PHP_EOL;
}
?>

如果业务需要把错误交给 Fiber 内部的 try/catch，可以在挂起后调用 throw($exception)。它不是把异常作为普通字符串传回，而是让异常从原来的 Fiber::suspend() 位置抛出；外层可以根据 Fiber 是否终止决定是否读取最终返回值。

Fiber 和 Generator 怎么选

Generator 适合“产生一串可迭代值”的协议，调用方通常通过 foreach、current()、send() 推进；Fiber 适合把一段可能在深层函数中暂停的工作交给调度器。Fiber 有独立调用栈，暂停点所在的普通函数不必改变成返回 Generator 的形式。

实际项目里，Fiber 不是线程，也不会自动并发执行。它只保存可中断的调用栈，何时恢复、恢复传什么值，仍由事件循环或调度器决定。若只是遍历数据流，Generator 往往更直观；若要让深层 I/O 适配器暂停并把控制权交回调度器，Fiber 的调用栈语义更合适。

常见问题

为什么 start() 返回了值，嵌套函数却没有直接得到它？

start() 返回的是 Fiber 对外交出的挂起值，不是恢复值。嵌套函数要得到外部输入，必须在 suspend() 所在位置等待 Fiber 被 resume($value)。

resume() 的返回值什么时候不是最终结果？

只要 Fiber 还会再次挂起，resume() 返回的就是下一次挂起值；Fiber 直接结束时通常得到 null，最终业务结果统一从 getReturn() 读取。

可以在普通 PHP 函数里直接调用 Fiber::suspend() 吗？

可以，只要这个函数正在 Fiber 的调用栈中执行；如果从 Fiber 外部调用，PHP 会抛出 FiberError。