Fiber是PHP内建的底层调度原语，支持单线程内任意深度调用栈的暂停与恢复；suspend()必须在Fiber闭包内部调用，否则抛出“Cannot suspend outside a fiber”错误，因其依赖TLS检测当前是否处于Fiber上下文。
Fibers 不是“另一个协程扩展”，它是 PHP 运行时内建的、可精确控制执行流的底层调度原语——没有它，你写的 async/await 风格代码只能靠 generator 模拟，且无法跨函数挂起；有了它，才能真正实现单线程内任意深度调用栈的暂停与恢复。
为什么 Fiber::suspend() 必须在 Fiber 闭包内部调用
这是最常踩的坑：在主流程里直接写 Fiber::suspend() 会抛出 FiberError: Cannot suspend outside a fiber。因为 suspend() 是一个上下文敏感操作，它依赖当前执行栈属于某个 Fiber 实例的私有栈空间。运行时通过 TLS（线程局部存储）检查当前是否处于 Fiber 上下文中。
- 只有
new Fiber(function() { ... })创建的闭包，在被start()或resume()激活后，其内部才具备合法的 Fiber 上下文 -
suspend()本质是触发一次栈快照保存 + 控制权移交，这个动作必须由“正在被调度的 Fiber”发起 - 误在外部调用，等价于让主线程自己“冻结自己”，PHP 运行时明确禁止这种自毁行为
Fiber->resume($value) 的传参如何进入挂起点
resume() 传入的参数不会自动绑定到变量，而是作为 suspend() 调用的返回值出现。这和 generator 的 send() 行为一致，但机制完全不同：Fiber 是寄存器级恢复，$value 被直接载入 RAX（或对应返回寄存器），成为 suspend() 表达式的计算结果。
- 若
suspend()前有表达式（如$x = Fiber::suspend('a')），则$x就是resume()传入的值 - 若
suspend()是独立语句（如Fiber::suspend();），则传参会被丢弃，但 Fiber 仍会继续执行 - 传入
Exception实例时，它会在suspend()调用点以异常形式抛出，可被同一作用域的try/catch捕获
Fiber 状态机与生命周期不可跳过的关键检查
Fiber 对象不是状态自由的容器，它的方法调用受严格状态约束。比如对已终止（dead）的 Fiber 再调用 resume()，会立即报 FiberError: Cannot resume a dead fiber；而对未启动的 Fiber 调用 resume() 则报 Cannot resume a suspended fiber that has never been started。
立即学习“PHP免费学习笔记（深入）”；
- 初始状态为
INITIALIZED，仅允许调用start() -
start()后变为SUSPENDED（若遇到suspend()）或DEAD（若自然结束） - 只有
SUSPENDED状态才接受resume()；DEAD后任何操作都非法 - 没有
isRunning()这类查询方法，状态需靠开发者逻辑维护，运行时只做刚性校验
PHP 8.1 与 8.6 在 Fiber 调度上的实际差异点
8.6 并没有新增 public API，但底层调度路径被重写：栈分配改为惰性（lazy stack allocation），suspend()/resume() 平均延迟下降约 40%。这意味着你在 8.1 写的 Fiber 代码能直接跑在 8.6 上，但高并发场景下，相同逻辑在 8.6 中更少触发栈扩容、上下文拷贝开销。
- 8.1 中每个 Fiber 构造即分配默认 128KB 栈；8.6 改为首次
start()时按需分配，初始仅几 KB - 8.6 引入调度亲和性（scheduler affinity），同一线程创建的多个 Fiber 更倾向复用 CPU 缓存行，减少 TLB miss
- 无代码改动即可受益，但若你手动调用
gc_collect_cycles()频繁清理 Fiber 对象，8.6 下收益更明显——因为栈内存释放更及时
真正难的是把「挂起时机」从 I/O 边界下沉到业务逻辑内部：比如一个订单创建流程中，不是等 curl 执行完才 resume，而是把库存扣减、优惠券核销、日志落库这些子步骤各自拆成可挂起单元。这要求你放弃「函数必须执行到底」的惯性，转而信任 suspend/resume 的原子性与异常传播能力——而这恰恰是 Fiber 最锋利、也最容易划伤自己的地方。
