PHP Fibers怎样把阻塞任务封装成可恢复协程为什么结果为空或不符合预期

PHP Fiber 能保存调用栈并在显式挂起后恢复，但把阻塞函数放进 Fiber 不会自动让 I/O 非阻塞。结果为 null 时，首先区分三个通道：start 或 resume 返回下一次挂起交出的值，resume 的参数进入 suspend 表达式，而协程函数的最终返回值要在正常结束后通过 getReturn 读取。

PHP 官方地址：https://www.php.net/

准备一个只演示恢复语义的小实验

使用支持 Fibers 的 PHP 8.1 及以上 CLI 环境，保存脚本为 fiber_demo.php。本实验不引入网络请求、数据库和事件循环，先排除连接超时等干扰，只观察挂起和恢复的值。不要将 CLI 与 Web 服务使用不同 PHP 版本导致的差异误判为 Fiber 本身失效。

把挂起消息、恢复输入和最终结果分开

代码里的 Fiber 交出任务描述，外部随后提供恢复输入，最后读取业务结果。这是协作式接口协议，调度者必须约定每一次 suspend 交出的对象代表什么。

 'lookup', 'key' => $key]);
    if (!is_string($value)) {
        throw new UnexpectedValueException('任务结果必须是字符串');
    }
    return strtoupper($value);
});

try {
    // start 返回 suspend 交出的任务描述，不是最终业务返回值
    $request = $fiber->start('item-7');
    echo json_encode($request, JSON_THROW_ON_ERROR), PHP_EOL;

    if (!$fiber->isSuspended()) {
        throw new LogicException('协程不在挂起状态');
    }
    // resume 的参数成为 suspend 表达式的返回值
    $nextYield = $fiber->resume('ready');
    var_dump($nextYield); // 此次直接结束，所以这里为 NULL

    if ($fiber->isTerminated()) {
        echo $fiber->getReturn(), PHP_EOL; // 最终结果应为 READY
    }
} catch (Throwable $error) {
    // 异常保留为失败信息，不用 null 冒充一个成功业务结果
    fwrite(STDERR, $error->getMessage() . PHP_EOL);
    exit(1);
}

由代码语义可推导：第一行应是带 task 与 key 的 JSON；var_dump 对应 NULL；最后一行应为 READY。这里是读者复现时的预期，不是本文实际执行所得结果。运行方式如下：

# 在 CLI 中运行示例；若异常则脚本返回非零退出码
php fiber_demo.php

start 收到的是 Fiber::suspend 交出的数组。resume('ready') 把字符串交给挂起点，挂起点继续执行并返回 READY。由于中间没有第二次 suspend，resume 自己返回 null；这个 null 并不代表业务结果丢失。

为什么不能只判断 resume 的返回值

协程可以多次挂起，每次交出不同消息；也可以一次都不挂起直接结束。因此使用 empty 或把 null 当作“任务结束”都不可靠。把 isSuspended、isTerminated 与自己的任务协议一起看，结束后再读取最终返回值。getReturn 要求协程正常返回，尚未结束或因异常终止时不能把它当成功结果读取。

包装阻塞函数为什么没有自动并发

普通协程封装如果仍调用同步 I/O，执行该调用时当前线程会等待，外部调度器也无法凭空把它暂停。真正的异步运行环境需要非阻塞 I/O、就绪事件与等待队列：调度器记录哪个 Fiber 等待哪项资源，在资源就绪后恢复相应 Fiber。

在同步 file_get_contents 前后各加一次 suspend，只能改变业务代码的暂停位置，不能把中间的阻塞读取转换成异步。类似地，在 Fiber 里调用 sleep 也不会自动让其他 Fiber 运行。需要采用支持相应 I/O 的事件循环或协程库，或把必须阻塞的任务放到独立工作进程中；并发策略不能从 Fiber 关键字直接推出。

把示例扩展为真实任务时保留异常和状态

为每个待执行任务分配标识，并把“成功值”“失败异常”“取消状态”写入调度协议。调用 start 和 resume 的边界捕获 Throwable，避免将异常转换成没有解释的 null。准备取消和超时策略时，还要明确释放资源的职责；不应在不知道 Fiber 当前状态时反复 resume。

资源跨挂起点存活是 Fiber 的能力，也是维护负担。文件句柄和连接应在协程自身的清理逻辑中关闭；不要只删除外部引用就假定运行中的资源已经按业务要求结束。本实验没有外部句柄，所以无需新增关闭动作。

已经结束的 Fiber 能否再次启动

不能把一个 Fiber 当成可无限重启的任务容器。每个 Fiber 有自己的生命周期，需要重复任务时应按设计新建实例；重复 start 或恢复非挂起实例会产生状态错误。

为什么恢复后代码没有拿到传入字符串

确认字符串是传给 resume，而不是错误地再次传给 start；确认使用的是 Fiber::suspend 的返回表达式；再排除类型检查抛出的异常。如果代码在恢复前就正常结束，根本不存在接收恢复输入的挂起点。

官方语义说明：https://www.php.net/manual/en/language.fibers.php；启动、恢复和最终结果分别参见 https://www.php.net/manual/en/fiber.start.php、https://www.php.net/manual/en/fiber.resume.php、https://www.php.net/manual/en/fiber.getreturn.php。