PHP Fiber 怎样把深层调用栈暂停后恢复

PHP Fiber 的关键价值，是暂停点不必位于最外层回调。深层函数执行到 Fiber::suspend() 时，整条 Fiber 调用栈都会暂时停住；外部的 start() 或 resume() 先拿到暂停值，下一次 resume() 传入的值又会回到暂停点继续执行。这样可以把协作式调度放进事件循环，而不用把每一层函数都改成 Generator。

官方文档：https://www.php.net/fibers

先确认 start 与 suspend 的值怎样交接

Fiber 创建后不会自动运行。第一次调用 start()，回调从头执行到 Fiber::suspend('ready')，start() 返回 ready。此时回调还没有结束，外部保存的 Fiber 对象仍是后续调度入口。

start();
echo "启动结果：{$first}", PHP_EOL;
$fiber->resume('continue');

// 输出顺序体现控制权先回到外部，再回到 Fiber 内部。
// 启动结果：ready
// 恢复信号：continue

把暂停点放进深层调用栈

Fiber 与 Generator 的一个重要区别，是它拥有自己的调用栈。下面让 loadPart() 调用 waitForScheduler()，暂停点位于第二层函数；调用方不需要逐层接收 Generator，也不需要改写 loadPart() 的返回类型。

start();
if ($fiber->isSuspended()) {
    // 调度器把结果送回暂停点，随后执行会回到 loadPart。
    $fiber->resume('42');
}

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

这里的 $request 是“需要调度”的信号，resume('42') 传回深层的 suspend()，最终返回值才会沿着原调用栈回到 Fiber 回调。不要把第一次 start() 返回值当成最终业务结果。

用生命周期状态避免重复恢复

调度器至少要区分三种状态：刚创建但未启动、已经暂停、已经结束。最简单的检查清单如下：

生产代码里不要用“调用一次 resume 试试看”的方式判断状态。对已结束 Fiber 重复恢复会抛出 FiberError；而尚未结束时调用 getReturn() 也不是读取中间结果的办法。

异常恢复与资源清理要放在同一条边界

resume() 适合送回正常值，throw() 适合让暂停点感知取消、超时或调度失败。暂停点周围应保留 try/finally，这样外部注入异常时仍能释放临时资源。

start() === 'waiting' && $fiber->isSuspended()) {
    // 取消并非普通返回值，直接从 suspend 点抛入异常。
    $fiber->throw(new RuntimeException('scheduler cancelled'));
}

如果 Fiber 回调没有捕获这个异常，异常会从 throw() 调用处继续冒泡，调用方应按普通异常边界记录或转换。调度器不要把异常文本当成成功结果，也不要在 finally 中再次调用 Fiber::suspend()。

常见问题

Fiber::suspend 可以在主程序中直接调用吗？

不可以。它必须在当前 Fiber 内执行；从 Fiber 外部调用会抛出 FiberError。

resume 传入的值去了哪里？

它会成为暂停点那次 Fiber::suspend() 调用的返回值，而不是自动传给 Fiber 回调的参数。

怎样取得 Fiber 最终返回值？

等 isTerminated() 为真后调用 getReturn()。第一次 start() 或中间的 resume() 返回的可能只是暂停值。

把 Fiber 当成“可被调度器反复接管的调用栈”即可：外部负责状态与时机，深层函数负责在明确的暂停点交出控制权，resume 与 throw 分别承载正常结果和异常路径。