Fibers 挂起恢复怎么配置或排查

PHP Fibers 挂起后恢复不需要额外的 php.ini 开关。先确认运行时是 PHP 8.1 或更高版本，并确认代码调用的是同一个 Fiber 对象；然后把 start()、Fiber::suspend()、resume() 和 throw() 看成一组值与异常的传递协议。大多数“恢复没反应”问题，实际是状态已经终止、恢复调用方拿错了值，或把阻塞 I/O 误当成了自动并发。

先确认 Fiber 可用，再固定挂起点

运行环境先查版本和类是否存在。Fiber 从 PHP 8.1 开始提供，正常的核心构建不需要再安装一个名为 Fiber 的扩展。下面的检查只用于把环境问题和控制流问题分开：

start();
var_dump($firstValue, $fiber->isSuspended()); // ready, true
?>

如果执行到 Fiber::suspend() 外部，PHP 会抛出 FiberError。因此“挂起点”必须位于正在运行的 Fiber 调用栈里；它不会暂停主脚本，也不会替你创建事件循环。

用 start、suspend 和 resume 对齐值的方向

最容易记错的是值的方向：suspend('ready') 的参数会成为 start() 的返回值；之后调用 resume('ok')，'ok' 才会成为 Fiber 内部 suspend() 表达式的返回值。

start(); // 收到 ready，Fiber 进入 suspended
if ($fiber->isSuspended()) {
    // 只有 suspended 状态才能 resume；参数会成为 $reply。
    $fiber->resume('ok');
}
?>

这里的 resume() 返回值通常不是业务结果，因为它返回的是 Fiber 下一次挂起时向外提供的值，或者在 Fiber 直接结束时返回 null。最终返回值应在 isTerminated() 为真后用 getReturn() 读取。

用状态方法判断下一步动作

排查时不要只盯着一行 resume()。先打印同一个对象的生命周期状态，再决定是启动、恢复还是读取结果：

start() 第二次调用、对未挂起的 Fiber 调用 resume()，通常都会落到 FiberError。这类错误不是“配置少了参数”，而是调用方没有和状态机对齐。生产代码可以把“当前只能做什么”封装在一个小的调度器里，减少散落在业务层的状态判断。

用 throw 处理挂起点的异常恢复

超时、取消或下游失败不适合伪装成普通字符串。Fiber 处于 suspended 状态时，可以用 throw() 把异常送回刚才的 suspend() 位置；Fiber 内部用 try/catch 决定清理、重试还是向外抛出：

getMessage());
    }
});

$fiber->start();
if ($fiber->isSuspended()) {
    // throw() 只能作用于 suspended Fiber，异常从 suspend() 处进入。
    $fiber->throw(new RuntimeException('上游超时'));
}
?>

若异常没有被 Fiber 回调捕获，异常会从 throw() 调用处继续向外传播。不要在 Fiber 已经终止后再次调用 getReturn() 期待拿到异常结果；应该让异常进入统一错误处理路径。

一张清单收紧配置与排错边界

• 先执行 php -v 或记录 PHP_VERSION_ID，再检查 class_exists(Fiber::class)。
• 恢复前确认对象来自当前请求或当前调度器，且 isSuspended() 为真。
• 把 suspend() 的出参、resume() 的入参和最终 getReturn() 分开记录。
• 异常路径使用 throw()，并让 Fiber 内部负责清理。
• Fiber 只提供协作式切换；如果回调里执行阻塞 I/O，没有事件循环或非阻塞实现，仍会阻塞当前线程。

相关问题

PHP Fibers 需要在 php.ini 中开启吗？

通常不需要独立开关。先确认 PHP 版本至少为 8.1，并用 class_exists(Fiber::class) 检查当前运行时。

为什么 resume() 调用后 Fiber 没有继续？

先确认 Fiber 当时确实 suspended；若它已经 terminated，说明回调已经返回或异常结束，不能再次恢复。

Fiber 能把阻塞的 sleep 变成异步吗？

不能单靠 Fiber 做到。需要事件循环或非阻塞 I/O 配合，Fiber 只负责保存调用栈并在明确的挂起点切换控制权。