workerman协程跨版本兼容老代码需避免直接运行v4阻塞调用，否则卡死进程；应优先用coroutine::exec包装同步逻辑，或逐步替换为协程版i/o（如http-client、mysql、swow api），并保持mvc结构不变，仅改造dao层。
Workerman协程跨版本兼容老代码时，不能直接把v4的阻塞调用扔进v5协程环境里跑，否则整个worker进程会被卡死，新连接全部挂起；必须在不重写业务逻辑的前提下，让原有同步代码在协程中安全执行。
用Coroutine::exec包装老代码
这是最轻量的兼容方案，适用于已封装成函数或方法的旧逻辑，比如一个读取本地配置文件的函数、调用file_get_contents获取远程HTML的工具方法。
第一步：在Worker启动前引入协程支持——【必须放在Worker::runAll()之前，且不能晚于autoload加载】
require_once __DIR__ . '/vendor/autoload.php';
第二步：找到老代码调用点，在onMessage或onConnect回调里用Coroutine::exec包裹原调用
$result = Coroutine::exec(function () { return file_get_contents('https://old-api.com/data'); });
第三步：注意返回值是Promise对象，需await解包——【不await会导致$result是协程句柄而非实际数据，后续var_dump会报错】
$body = await $result;
这一步操作起来很简单，直接把原来的file_get_contents()替换成Coroutine::exec包裹的匿名函数就行。但要注意：exec内部仍会触发PHP原生阻塞，只是被协程运行时拦截并挂起当前协程，不影响其他连接处理。
替换阻塞函数为协程版替代品
当老代码大量使用sleep、curl_exec、pdo->query等硬阻塞调用时，Coroutine::exec无法解决性能瓶颈，必须逐个替换为协程友好版本。
方法一：用workerman/http-client替代curl_exec
composer require workerman/http-client → 替换curl_init + curl_exec为$client->get() + await
方法二：用workerman/mysql替代PDO
composer require workerman/mysql → 把new PDO(...)改成new Workerman\Mysql\Connection(...)，查询语句加await
方法三：用Swow内置协程API替代sleep和file_get_contents
Swow\Timer::sleep(1)替代sleep(1)，Swow\Socket::readFile()替代file_get_contents()
注意：Swow方案仅在启用Swow驱动时生效，且【PHP必须≥8.0，否则Swow扩展无法加载】
保留原逻辑结构，只改底层I/O调用
如果老项目采用MVC分层，Controller调用Service，Service调用Dao，那么只需修改Dao层——Controller和Service完全不动，只把Dao里的PDO操作、HTTP请求、文件读写替换成协程版。
① 定义接口统一契约：interface UserDao { public function getUserById(int $id): array; }
② 实现协程版：class CoroutineUserDao implements UserDao { public function getUserById(int $id): array { return await $this->db->select('*')->from('users')->where(['id' => $id])->query(); } }
③ 在Worker初始化时注入协程版实例：$container->set(UserDao::class, new CoroutineUserDao($db));
④ Controller中仍写$userDao->getUserById(123)，完全不用改调用方式
这种改法对测试覆盖率高的项目最友好，单元测试照常运行，只需确保Dao层返回值类型一致即可。协程调度由Workerman自动完成，上层代码感知不到变化。
