PHP Fiber是语言原生协程机制而非框架，仅提供暂停/恢复执行流能力；需配合事件循环与非阻塞I/O驱动才能实现真正异步，并注意异常捕获、调试支持及生命周期管理。
PHP 的 Fiber 不是框架，而是语言原生协程机制
很多人搜“Fiber 框架”，其实是被名字误导了——PHP 8.1+ 内置的 Fiber 是一个类，不是框架。它不提供路由、中间件、HTTP 服务等能力，只负责暂停/恢复执行流。所谓“用 Fiber 处理异步任务”，本质是手动或借助调度器把阻塞点（如 I/O）变成可挂起的协作点。
常见误解：以为 new Fiber(...) 一跑就自动并发。错。它只是给你一个可中断的函数容器，挂起后谁来唤醒？什么时候唤醒？靠谁监听 I/O 就绪？这些全得你补上。
Fiber::suspend() 不能让同步函数变非阻塞
下面这段代码看似“异步”，实则仍是串行阻塞：
$fiber = new Fiber(function() {
$data = file_get_contents('https://api.example.com/data'); // ❌ 同步阻塞，整个线程卡住
return $data;
});
$fiber->start();
原因很直接：Fiber::suspend() 只是交出控制权，但它无法穿透 file_get_contents() 这类同步系统调用。真正要并发提速，必须满足两个前提：
- 底层 I/O 必须是非阻塞的（比如用
Swoole\Coroutine\Http\Client或Amp\Http\Client） - 需要一个事件循环持续监听 socket 就绪，并在就绪时调用对应
Fiber的resume()
换句话说：Fiber 是“挂起能力”，不是“异步能力”。没有事件循环和非阻塞驱动，它就是个高级 yield。
真实可用的异步任务模式：Fiber + 事件循环 + 协程客户端
以并发请求 3 个 API 为例，典型结构是：
// 用 Swoole 示例（需启用协程）
Swoole\Runtime::enableCoroutine();
$fibers = [];
for ($i = 0; $i < 3; $i++) {
$fibers[] = new Fiber(function(int $id) {
$client = new Swoole\Coroutine\Http\Client('api.example.com', 443, true);
$client->set(['timeout' => 5]);
$client->get('/data?id=' . $id);
return $client->body; // ✅ 协程客户端内部已挂起等待，不阻塞线程
});
}
$results = array_map(fn($f) => $f->start(), $fibers); // 同时启动，立刻返回（非阻塞）
// 此时所有 HTTP 请求已在后台并发发出
foreach ($fibers as $fiber) {
echo $fiber->resume(); // 等待并获取结果
}
关键点：
-
Swoole\Runtime::enableCoroutine()把同步函数（如fopen、curl_exec）自动转为协程友好调用 - 每个
Fiber内部调用的是协程版 HTTP 客户端，其get()内部会触发Fiber::suspend()，由 Swoole 事件循环接管 - 你不用手写调度逻辑，Swoole 的协程调度器已封装好
suspend/resume配对
调试时堆栈断裂和错误捕获容易失效
Fiber 切换后，异常堆栈默认不跨边界。比如在 Fiber 内部抛出异常，主流程的 try/catch 捕不到：
$fiber = new Fiber(function() {
throw new RuntimeException('in fiber');
});
try {
$fiber->start();
} catch (Throwable $e) {
// ❌ 不会进这里
}
// ✅ 正确做法：在 Fiber 内部处理，或用 Fiber::throw()
$fiber->start();
$fiber->resume(); // 触发执行，异常会在 resume 时抛出
更隐蔽的问题是 Xdebug 调试：PHP 8.1 初期版本中，断点可能无法停在 resume() 后的代码行；堆栈追踪里看不到跨 suspend 的调用链。现在 Xdebug 3.2+ 已支持，但需确认版本并启用 cli.debug 配置。
最常被忽略的一点：Fiber 生命周期管理。启动后没调用 resume()，或者重复 resume() 已结束的 Fiber，会直接报 Fiber is dead 或 Fiber is running 错误——这类状态检查必须写在业务逻辑里，没有自动兜底。
