php 8.1 fiber知识体系按生命周期分四阶段：创建（new fiber(闭包)）、启动（start()）、挂起/恢复（suspend()/resume()）、终止判断（isterminated()）；数据流向含单向传出、双向传递、异常注入；错误分状态非法、上下文越界、值类型穿透三类。
你需要把零散的PHP 8.1纤程（Fiber）回调相关笔记整理成可快速检索、便于复用的知识体系，避免每次写异步逻辑时重复翻查文档或试错。
按生命周期阶段分类
这是最贴近实际编码流程的分类法，直接对应 Fiber 对象从创建到终止的完整过程。
第一步：创建并初始化
使用 new Fiber(callback) 实例化，注意回调函数必须是闭包或可调用对象，且不能是普通函数名字符串——【传入非闭包会导致 Fatal error: Uncaught ValueError】。
第二步：启动执行
调用 $fiber->start() 进入纤程体，执行至首个 Fiber::suspend() 即刻返回，主流程继续；此时纤程状态为 started，不可重复调用 start()。
第三步：挂起与恢复Fiber::suspend($value) 会立即交出控制权，并将 $value 返回给调用 start() 或 resume() 的一方；后续必须通过 $fiber->resume($data) 恢复，否则纤程永远停滞——【未 resume 的 suspended 纤程会泄漏内存，无法被 GC 回收】。
第四步：终止判断
调用 $fiber->isTerminated() 可确认是否已自然退出或抛出未捕获异常；一旦终止，再调用 resume() 将触发 FiberError。
按数据流向分类
聚焦值如何在主流程与纤程之间传递，解决“参数怎么进、结果怎么出”的实操困惑。
方法一：单向传出（启动时获取挂起点值）$fiber->start() 返回的是 Fiber::suspend($val) 中的 $val，这是唯一一次从纤程向主流程单向传值的机会。
方法二：双向传递（恢复时带入 + 执行后返回）$fiber->resume($input) 的 $input 会成为 Fiber::suspend() 调用的返回值；而纤程最终 return $output 或抛出异常，则由 resume() 调用本身返回或抛出——这一步容易混淆，务必记住：【resume() 的返回值 = 纤程 return 的值，不是 suspend() 的参数】。
方法三：异常注入（调试与错误模拟）
用 $fiber->throw(new Exception('msg')) 可强行在纤程挂起点抛出异常，适用于测试错误处理路径；但仅对仍处于 suspended 状态的纤程有效。
按错误场景分类
把踩过的坑归为三类，方便下次遇到同类报错直接定位。
类型1：状态非法操作
对已终止纤程调用 resume() → 报 FiberError: Cannot resume a terminated fiber；对未启动纤程调用 resume() → 报 FiberError: Cannot resume a non-suspended fiber。
类型2：上下文越界
在非纤程上下文中调用 Fiber::suspend()（比如直接在全局作用域写）→ 致命错误 Fatal error: Uncaught FiberError: Cannot suspend outside a fiber。
类型3：值类型穿透失败
若 suspend() 传入资源类型（如 fopen() 返回的 resource），在某些 SAPI（如 PHP-FPM）下可能引发不可预测行为；应始终传递数组、字符串、对象等可序列化类型。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
