PHP Fiber 挂起后怎么传递异常并让调用方处理

PHP Fiber 挂起后，异常不是靠共享变量“通知”进去的。只要 Fiber 正停在 Fiber::suspend()，调用方就可以调用 Fiber::throw()，让异常从这个挂起点恢复执行；Fiber 内部能捕获就地处理，不能捕获的才会继续抛回调用方。

先把 Fiber 的四个状态动作对上

容易混淆的是“挂起时返回的值”和“Fiber 最终返回的值”。start() 首次执行回调，遇到第一次 suspend() 就把挂起值交给调用方；之后 resume($value) 会把这个值作为挂起表达式的结果。若调用方改用 throw($exception)，恢复点得到的不是普通值，而是从 suspend() 位置抛出的异常。

让 Fiber 自己处理挂起期间的异常

把 suspend() 放进 try，就能把调用方注入的异常转换成一个正常的业务结果。下面的例子模拟等待外部资源：调用方发现等待失败后注入 RuntimeException，Fiber 捕获它并返回降级结果。

getMessage();
    }
});

echo $fiber->start(), PHP_EOL; // 输出：等待上游响应
$fiber->throw(new RuntimeException('上游超时')); // 结束 Fiber，返回值在 getReturn() 中读取

if ($fiber->isTerminated()) {
    echo $fiber->getReturn(), PHP_EOL; // 输出：已降级：上游超时
}
?>

这里 throw() 本身没有替代 getReturn() 的职责：它只负责恢复 Fiber 并注入异常；回调捕获异常后返回的字符串，仍然要等 Fiber 终止，再通过 getReturn() 读取。

未处理的异常会回到调用方

如果 Fiber 内没有匹配的 catch，异常不会被静默丢弃。它会从 throw() 调用处继续向外抛，调用方应把这里当成一次普通的异常边界处理。另一个边界是状态：Fiber 尚未挂起、已经结束或当前正在运行时，不能随意调用 throw()，否则会得到 FiberError。

start();

try {
    $fiber->throw(new LogicException('调用方终止本次工作'));
} catch (LogicException $e) {
    // 在这里统一记录、转换或交给上层请求处理器。
    echo '调用方收到：' . $e->getMessage(), PHP_EOL;
}
?>

Fiber 和 Generator 的选择边界

两者都能暂停执行，但模型不同。Fiber 有自己的完整调用栈，深层函数可以直接调用 Fiber::suspend()，调用方还可以在挂起时用 throw() 把异常送回暂停点。Generator 更像一个由 yield 驱动的迭代器，调用方通常围绕 current()、send() 和 throw() 组织数据流，函数返回类型也会变成 Generator。

• 需要暂停深层调用、由外部调度恢复或注入取消异常：优先考虑 Fiber。
• 目标是逐项产出数据、遍历集合或实现惰性序列：Generator 更直观。
• 无论选哪一个，都先检查当前状态，再决定调用 resume()、throw() 还是读取最终返回值。

常见问题

Fiber::throw() 可以在 Fiber 尚未 start 时调用吗？

不可以。先用 start() 让 Fiber 运行到挂起点；尚未挂起时调用会触发状态错误。

异常被 Fiber catch 后还能在调用方 catch 到吗？

通常不能。被 Fiber 内部 catch 接住后，异常已在 Fiber 内消费；调用方应读取 getReturn() 得到处理结果。

为什么不能马上调用 getReturn()？

Fiber 必须已经终止并正常返回。仍在挂起或因异常终止时，getReturn() 都不是合适的读取入口。