PHP Fibers 怎样理解协作式切换边界

PHP Fibers 的协作式切换，指执行中的 Fiber 主动挂起，由调用方或调度框架在合适时机恢复。它保存的是一份可暂停的调用栈，不是自动开启线程，也不会让普通阻塞数据库查询或文件读取变成异步。没有挂起点，当前代码就会继续运行到返回或异常。

我理解这种能力时，更愿意先看控制权归谁，而不是先把它叫作“并发加速”。本文用一个嵌套计算示例说明切换边界；第一人称只是解释取舍，不代表生产实测或亲历性能结果。

PHP官方文档：https://www.php.net/manual/en/language.fibers.php

Fiber 不会自动分配另一个线程

Fibers 从 PHP 8.1 起提供。一个 Fiber 可以在深层函数中挂起，并保留相关调用栈。与普通函数不同的是，返回调用方的契机不只有函数结束，还可以是主动挂起；与线程并行不同的是，Fiber 本身没有自动让多个计算同时占用多个CPU核心。

我会把系统拆成调用方、Fiber调用栈和调度规则三个对象。调用方负责启动或恢复；Fiber中的业务函数决定或间接触发挂起；调度规则决定何时处理下一个任务。仅创建多个Fiber对象，不会自然得到公平轮转。

普通函数与挂起函数的差别

普通同步函数返回结果前，调用方等它完成。挂起函数则允许中途交出控制权，再从暂停位置继续。这个差别是控制流能力，不是业务结果自动变好。同步代码被包进Fiber后，如果里面没有任何可协作的挂起点，它仍会占住当前执行路径。

Generator也能表达暂停，但Fiber可以保留独立调用栈，在更深的函数调用中挂起，而不要求每层改成返回Generator。这个能力适合由框架封装等待的调用形式，不意味着所有现有函数都能不经适配加入异步调度。

用嵌套调用理解保存的边界

下面代码需要 PHP 8.1及以上。它没有网络或数据库，只用整数数组演示深层挂起。示例未在本文任务中执行，后文说明的是读者可核对的预期语义。

 'need-factor', 'sum' => $sum]);
    if (!is_int($factor) || $factor  10) {
        throw new InvalidArgumentException('倍率不合法');
    }
    return $sum * $factor;
}

$fiber = new Fiber(function (): int {
    try {
        // 外层函数保持普通返回类型，暂停发生在内层
        return scaledTotal([2, 4]);
    } finally {
        // 此处只说明正常退出或异常展开时的清理位置
        echo "计算范围结束", PHP_EOL;
    }
});

try {
    $event = $fiber->start();
    // start返回挂起事件，而不是最终乘积
    echo $event['kind'], ':', $event['sum'], PHP_EOL;
    if ($fiber->isSuspended()) {
        $next = $fiber->resume(3);
        // 本例恢复后直接结束，没有第二个挂起事件
        var_dump($next);
    }
    if ($fiber->isTerminated()) {
        echo $fiber->getReturn(), PHP_EOL;
    }
} catch (Throwable $error) {
    // 教学示例只输出错误类别，不泄漏业务数据
    echo get_class($error), PHP_EOL;
}

正常路径中，第一次启动得到包含求和值6的事件；恢复传入3后，这个值成为原 Fiber::suspend() 表达式的结果。业务函数计算18，回调结束。此时恢复方法没有再交出挂起值，应返回NULL，最终业务返回通过 getReturn() 读取。清理文字表示代码设计的finally位置，不是本次实际运行日志。

将恢复值改成不允许的类型，会触发示例的参数异常。异常从执行Fiber的方法传播到外部捕获位置。不要把捕获异常后的“已终止”误当成正常返回；失败路径需要单独记录，不能一看到终止状态就期待得到成功结果。

值、状态和最终返回要分别读取

同一Fiber不能重复启动，恢复也需要符合其状态。我的取舍是让教学示例的控制权集中在一处；实际使用框架时，则由框架拥有调度权，不在业务代码中额外抢着恢复同一个Fiber。

阻塞调用和清理仍需单独设计

把普通 sleep、阻塞I/O或长时间纯计算放进Fiber，不会凭空释放控制权。要重叠等待，通常还需要非阻塞依赖、事件循环和与其集成的库；Fiber负责表达暂停，调度系统负责等待与恢复。CPU密集工作如果需要多核并行，应另评估进程或其他执行机制，不能仅增加Fiber数量。

暂停也不是资源释放。打开的资源、业务上下文和引用可能随挂起调用栈继续保留。finally适合表达正常退出或异常展开时的清理，但不能把“暂时挂起”理解成已经执行了清理，也不要依赖进程异常终止必然完成业务收尾。

建议读者采用时先问三个问题：依赖是否会主动挂起，谁拥有恢复权，失败与取消怎样结束。本文不实现取消或完整调度器，也不保证框架间可以任意互换。销毁和特殊回调中的切换限制存在版本差异，应按所用PHP版本和框架文档处理。

挂起之后会自动继续吗？

需要调用方或调度框架恢复，Fiber本身不提供定时自动恢复。

多个Fiber是否需要关注共享状态？

需要。即使没有线程并行，跨挂起点也可能被其他任务改变共享对象，应明确资源所有者和更新规则。

直接使用Fiber适合所有项目吗？

不适合。简单同步任务未必需要它；异步工程通常优先使用已有框架的调度与依赖集成，避免手写不完整的事件循环。

对我来说，理解Fiber最有用的结论是：挂起保留的是继续执行的上下文，恢复权属于明确的调用者，最终结果与中途交接分开。它简化某些协作控制表达，但线程并行、非阻塞I/O与资源生命周期仍是不同的问题。官方方法参考：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。