PHP Fibers怎样把阻塞任务封装成可恢复协程怎样完成一个可复用的最小示例

我第一次用 PHP Fibers，是在想把一段“先拿到中间结果、稍后再继续”的任务从回调里拆出来时。最容易误解的一点是：Fiber 不是自动并发按钮，它提供的是可暂停、可恢复的执行上下文；真正的等待、事件循环和任务调度，仍然要由应用或库来安排。

官方手册：https://www.php.net/manual/en/language.fibers.php

在 PHP 8.1 及以上，可以用 Fiber::suspend() 暂停一整段调用栈，再用 resume() 把值送回暂停点。要把它用于非阻塞任务，还需要一个能驱动恢复动作的调度器。

先理解 Fiber：它暂停的是一整段调用栈

Generator 通常要求调用链显式配合 yield，而 Fiber 有自己的调用栈。也就是说，暂停点可以位于业务函数调用的更深处，直接调用 Fiber::suspend()；外层调用者拿到暂停值后，Fiber 内部的局部状态会保留。

这个能力适合把“可继续的任务”封装成普通闭包。它不改变 PHP 的执行模型，也不会凭空创建线程；如果 Fiber 内部直接执行真正的阻塞 I/O，当前 PHP 进程仍会在那次 I/O 上等待。

最小示例：把阻塞步骤拆成可恢复任务

下面的例子把任务分成两个阶段：先启动并返回一个检查点，外部准备好继续所需的数据后，再恢复 Fiber。注意，示例展示的是控制权和值的传递，不代表这段代码已经在当前环境执行。

start();
echo $signal, PHP_EOL;

// 外部调度器在合适的时机恢复任务；这里的参数回到 suspend()。
$fiber->resume('外部结果已准备好');

// Fiber 结束后读取闭包的 return 值。
echo $fiber->getReturn(), PHP_EOL;

值的方向可以这样记：suspend('检查点') 把“检查点”交给 start() 或下一次切换调用；resume('继续值') 则让暂停点返回“继续值”。闭包结束后，最终 return 不再从 resume() 读取，而是从 getReturn() 读取。

把它封装成可复用的任务边界

实际项目里不要让调用方猜 Fiber 当前处于什么状态，可以把“启动、交出检查点、恢复、取结果”集中在一个小对象或调度器中。最少要区分未启动、运行中、已暂停和已结束几种状态。

isTerminated()) {
        throw new LogicException('Fiber 已结束，不能再次恢复');
    }

    // 未启动时必须调用 start()，已暂停时才使用 resume()。
    if (!$fiber->isStarted()) {
        return $fiber->start($value);
    }

    return $fiber->resume($value);
}

// 业务层只关心检查点和任务状态，不直接重复判断切换方法。
$fiber = new Fiber(function (): string {
    // 让调度器决定何时把外部数据送回来。
    return '完成：' . Fiber::suspend('等待数据');
});

$checkpoint = resumeOnce($fiber);
$fiber->resume('数据已就绪');
$result = $fiber->getReturn();

这个包装器仍然不是事件循环。若要同时管理多个任务，调度器必须保存每个 Fiber 的状态，并在 socket、定时器或其他外部事件就绪时选择对应的 Fiber 恢复。PHP 8.1 发布说明也把 Fibers 描述为实现轻量协作式并发的底层原语，而不是完整调度系统。

版本、异常与性能边界

首先确认运行环境至少是 PHP 8.1；更低版本没有内置 Fiber API。其次，Fiber::suspend() 必须在 Fiber 内调用，在外部调用会抛出 FiberError。恢复时如果业务失败，可以使用 throw() 把异常送入 Fiber，而不是把错误悄悄变成一个普通字符串。

start();
$fiber->throw(new RuntimeException('外部事件失败'));

最后看性能：Fiber 减少的是回调式控制流的组织成本，不会让 CPU 密集计算自动并行，也不会让同步文件或网络调用自动变成异步。对我来说，它最有价值的场景是给事件循环或异步库提供更接近同步代码的任务接口；如果项目没有调度器，直接创建 Fiber 往往只增加状态管理成本。

相关问题

PHP Fiber 和 Generator 有什么区别？

Fiber 有自己的调用栈，可以从嵌套调用中暂停；Generator 更偏向显式的 yield 迭代协议。两者都能暂停，但调用方式和适合的抽象不同。

只用 Fiber 能实现真正异步吗？

不能。Fiber 提供暂停和恢复原语，仍需要事件循环、非阻塞 I/O 或其他调度机制，才能在外部事件就绪时恢复任务。

Fiber 结束后还能 resume 吗？

不能。结束后应使用 isTerminated() 判断，并通过 getReturn() 读取闭包的最终返回值。