PHP 8.3 的 Fiber 仅提供挂起/恢复原语，不自动协程化 I/O，需搭配 Swoole 5.1 等扩展才能实现真正异步；单独使用 Fiber 会导致阻塞、内存泄漏和调度失效。
PHP 8.3 本身不支持开箱即用的协程，Fiber只是底层挂起/恢复原语，不是 async/await；想写真正非阻塞异步代码，必须搭配 Swoole 5.1 或类似扩展，否则 file_get_contents、PDO::query、curl_exec 全部照常阻塞主线程。
为什么直接 new Fiber() 写不出生产级协程服务
常见错误现象：写了 Fiber 却发现并发请求仍串行、响应时间没降反升、内存缓慢上涨最终 OOM。
根本原因在于：Fiber 不自动 hook I/O、不调度、不等待就绪事件——它只提供“暂停”和“恢复”两个动作，其余全靠你手动编排。
- 调用
file_get_contents('https://api.example.com')时，Fiber不会自动让出控制权，而是原地卡死，整个线程被阻塞 -
Fiber::suspend()后若无人调用resume()，该协程永久挂起，变成内存泄漏点 - 嵌套
suspend()（比如在回调里再suspend()）容易导致栈状态错乱，抛出FiberError - 没有运行时调度器时，
Fiber和普通函数调用行为几乎一致，只是多了个可中断的栈
Swoole 5.1 是 PHP 8.3 下唯一靠谱的协程落地路径
使用场景：HTTP API、Redis 缓存批量读写、MySQL 查询聚合、gRPC 客户端调用等 I/O 密集型任务。
立即学习“PHP免费学习笔记（深入）”；
关键配置与兼容性要点：
- 必须显式启用：
Swoole\Runtime::enableCoroutine()，且建议加flags参数开启完整 hook：Swoole\Runtime::enableCoroutine(SWOOLE_HOOK_ALL) - cURL 需要单独打开：
Swoole\Runtime::enableCoroutine(SWOOLE_HOOK_CURL)，否则curl_exec仍是同步阻塞 - 扩展版本强约束：
redis≥ 6.0.0、pdo_mysql+mysqlnd≥ 2.3.0，否则协程化后会 segfault 或返回空结果 - 禁用
opcache.enable_cli=1（CLI 模式下），否则 JIT 可能干扰 Fiber 栈帧管理，引发不可预测的FiberError
示例入口文件：
<?php
Swoole\Runtime::enableCoroutine(SWOOLE_HOOK_ALL | SWOOLE_HOOK_CURL);
<p>$server = new Swoole\Http\Server('0.0.0.0', 9501);
$server->on('request', function ($request, $response) {
// 这里所有 I/O 都是协程安全的
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$value = $redis->get('user:123'); // 不阻塞</p><pre class="brush:php;toolbar:false;">$mysqli = new mysqli('127.0.0.1', 'root', '', 'test');
$result = $mysqli->query('SELECT * FROM users LIMIT 1'); // 自动协程化
$response->end(json_encode(['redis' => $value, 'db' => $result->fetch_all()]));}); $server->start();
Fiber 在纯 CLI 场景下的合理用法
适用场景：命令行工具中需顺序控制多个耗时步骤（如分批处理 CSV、轮询外部状态、模拟有限状态机），但又不想 fork 进程或引入 event-loop。
核心原则：用 Fiber 替代状态变量 + while 循环，而非替代 I/O 并发。
- 不要在
Fiber里直接调用sleep(5)——它会阻塞整个进程；改用co::sleep(5)（Swoole）或stream_select()手动等待 - 每个
Fiber::suspend()必须有明确 resume 触发条件，例如：pcntl_signal_dispatch()收到 SIGUSR1、stream_select()返回就绪 fd、或另一个协程完成计算后主动通知 - 跨 Fiber 共享数据推荐直接读写变量（同一线程），但注意竞态：PHP 8.3 的
Fiber无内存隔离，$shared['counter']++非原子 - 异常传播是可靠的：
$fiber->throw(new RuntimeException('timeout'))会在其suspend()处精准抛出，堆栈上下文完整保留
Workerman 和 PHP 8.3 Fiber 完全不兼容
错误认知：“Workerman 支持异步，加上 PHP 8.3 就能跑协程”。真实情况是：Workerman 的“异步”本质是单线程事件循环 + 多进程模型，和 Fiber 零交集。
典型陷阱：
- 在 Workerman 回调中
new Fiber(...)->start()，该 Fiber 启动后立即因curl_exec阻塞，卡住整个 worker 进程 - 即使开了
opcache.jit=1205，Workerman 也未对任何 I/O 函数做 hook，Fiber无法感知 socket 就绪 - 试图自己实现调度器 hook 所有函数？成本远超换 Swoole，且极易破坏 Workerman 自身事件循环
结论很直白：要用 Fiber 做协程，就别选 Workerman；要继续用 Workerman，就别指望 Fiber 能帮你提升并发能力。
最容易被忽略的一点：Fiber 的生命周期完全由开发者控制，没人替你回收。一个忘了 resume() 的 Fiber，就是一块永远不释放的栈内存——PHP 8.3 不会 GC 它，Swoole 也不会自动清理，只能靠监控 Fiber::isSuspended() 状态+超时强制销毁。
