Fiber->start()必须在resume前调用，否则报致命错误；suspend()只能在Fiber内部调用；resume()与suspend()参数类型需匹配；Fiber不提供自动I/O非阻塞能力。
fiber->start() 必须在 resume 前调用，否则会报 Fiber::resume(): Cannot resume a fiber that has not been started
这是最常踩的坑：直接对刚 new 出来的 $fiber 调用 resume()，PHP 会立刻抛出致命错误。Fiber 的状态机是严格受控的——CREATED → STARTED → SUSPENDED → RESUMED → TERMINATED，跳过 start() 就等于没点火就踩油门。
实操建议：
- 永远先调用
$fiber->start()启动执行，哪怕它内部第一行就是Fiber::suspend() - 检查状态可用
$fiber->isStarted()和$fiber->isTerminated()，但不要依赖它们绕过生命周期规则 - 别在
start()前传参给 Fiber 回调函数——参数必须通过start($arg1, $arg2)或resume($arg)传入
Fiber::suspend() 只能在 fiber 内部调用，外部调用会触发 Fatal error: Uncaught Error: Cannot suspend outside a fiber
这个错误说明你试图在主线程或另一个 Fiber 外部调用 Fiber::suspend()。它不是静态工具函数，而是当前正在运行的 Fiber 的“暂停按钮”，只能由自己按。
常见误用场景：
立即学习“PHP免费学习笔记（深入）”；
- 在普通函数里写
Fiber::suspend()，没包在new Fiber(...)的回调中 - 在 Fiber 内部调用了一个封装了
Fiber::suspend()的工具函数，但该函数被意外复用到非 Fiber 上下文 - 用
call_user_func()动态调用含suspend()的闭包，却没确保它运行在 Fiber 栈内
正确做法是把所有含 suspend() 的逻辑，明确限定在 Fiber 构造函数的回调体内。
resume() 传参和 suspend() 返回值类型不匹配，会导致静默截断或类型错误
Fiber::suspend($value) 的返回值类型，由 resume($arg) 传入的参数决定，且不会自动类型转换。比如 suspend() 声明返回 string，但 resume(42) 传整数，就会触发 TypeError（如果启用了严格模式）或静默转成 "42"（弱类型上下文）。
关键细节：
- 回调函数的返回类型声明（如
: string）只约束最终return，不约束suspend()的返回值类型 -
suspend()的参数是“挂起时向外部返回的值”，而resume()的参数是“恢复时传给suspend()调用点的值”——二者语义不同，类型需独立校验 - 推荐在 Fiber 回调中显式类型断言，例如
$data = Fiber::suspend('default'); assert(is_string($data));
fiber 没有自动 I/O 非阻塞能力，别指望 suspend() 能让 file_get_contents 变异步
这是最大的认知偏差。Fiber 不是协程，它不拦截、不重写任何 PHP 原生函数。调用 file_get_contents('https://...') 或 mysqli_query() 依然会阻塞整个线程，哪怕你在 Fiber 里调用它。
真正可行的路径只有两条：
- 用底层非阻塞 API，比如
stream_socket_client(..., STREAM_CLIENT_ASYNC_CONNECT)+stream_select()，再配合suspend()/resume()手动调度 - 依赖扩展如
ext-uv或ext-swoole，它们提供了 Fiber-aware 的异步封装（例如Uv\TcpSocket::connect()）
换句话说：Fiber 是调度骨架，非阻塞 I/O 是血肉，缺一不可。漏掉后者，fiber 就只是个带暂停键的同步函数。
最易被忽略的点：Fiber 的栈是隔离的，但全局变量、静态属性、资源句柄（如 $pdo 实例）仍是共享的。多 Fiber 并发操作同一个数据库连接，不出问题才怪——得自己加锁或改用连接池。
