Workerman 4.1升级至5.0需四步：一卸载Swoole/Swow并更新版本；二启用Fiber驱动并安装revolt/event-loop；三将file_get_contents等阻塞调用替换为协程安全的http-client或mysql组件；四多Worker可分设Fiber与Swoole驱动但不可混用。
Workerman 4.1项目升级到5.0后，原有协程写法全部失效，onMessage里直接用file_get_contents会卡死整个服务，新手常因忽略驱动切换和回调执行模型变化而反复重启失败。
第一步：确认当前Workerman版本并清理旧协程依赖
执行composer show workerman/workerman，若输出含4.1.x字样，必须先卸载所有Swoole/Swow扩展——Workerman 5.0默认不兼容它们的协程钩子，残留扩展会导致eventLoop初始化失败或静默崩溃。
运行composer remove swoole ext-swoole（如有），再执行composer require workerman/workerman:^5.0。这一步不可跳过，否则后续所有协程配置均无效。
第二步：启用Fiber协程驱动（最简启动路径）
在启动脚本顶部加入：require_once __DIR__ . '/vendor/autoload.php';
创建Worker后，显式指定事件循环类：$worker->eventLoop = \Workerman\Events\Fiber::class;
【必须设置eventLoop，否则仍走4.1的同步回调模型】
启动时若报错Class 'Workerman\Events\Fiber' not found，立即执行composer require revolt/event-loop——这是Fiber驱动的底层依赖，缺它Worker根本无法进入协程上下文。
第三步：重写onMessage逻辑，避开阻塞函数
原4.1中常见的file_get_contents('https://...')、sleep(1)、mysqli_query()等操作，在5.0 Fiber模式下会冻结整个进程，必须替换为协程安全版本。
方法一：用workerman/http-client发HTTP请求
安装：composer require workerman/http-client
代码：$client = new Workerman\Http\Client(); $res = await $client->get('https://api.example.com');
方法二：用workerman/mysql替代PDO
安装：composer require workerman/mysql
连接后直接await $db->select(...)->query()，无需手动管理连接生命周期。
注意：Fiber不会自动协程化PHP内置函数，file_get_contents这种调用永远阻塞，绝不能出现在await语句外的任何位置。
第四步：多Worker混合协程驱动配置（进阶场景）
若需同时运行HTTP服务（用Fiber）与WebSocket网关（用Swoole），按以下顺序操作：
① 分别安装驱动依赖：composer require revolt/event-loop + pecl install swoole
② 创建第一个Worker并绑定Fiber：$http = new Worker('http://0.0.0.0:8080'); $http->eventLoop = \Workerman\Events\Fiber::class;
③ 创建第二个Worker并绑定Swoole：$ws = new Worker('websocket://0.0.0.0:8081'); $ws->eventLoop = \Workerman\Events\Swoole::class;
④ 启动前验证驱动可用性：var_dump(class_exists(\Workerman\Events\Swoole::class));，返回true才可启用该Worker。
切记：【同一Worker内不可混用Fiber/Swoole/Swow驱动，否则进程立即core dump】
