Webman默认不启用协程，必须在config/process.php中为指定进程显式配置eventLoop为Workerman\Events\Swoole::class，并确保Swoole扩展已安装且版本≥5.0，否则Coroutine::create()等调用无效且静默失败。
Webman 默认不启用协程，必须显式配置 eventLoop 并安装对应扩展，否则所有 Coroutine::create() 调用都无效，且不会报错 —— 这是绝大多数人踩坑的第一步。
确认 Swoole 扩展已正确安装并被 Webman 加载
Webman 的协程能力完全依赖底层事件循环驱动，Swoole 扩展不是“可选”，而是硬性前提。仅装 PHP 扩展还不够，必须验证 Webman 启动时实际加载的是 Swoole 事件循环。
- 运行
php start.php start -d，检查输出中Event-Loop行是否为Workerman\Events\Swoole::class（不是Select或Event） - 若显示其他类型，说明
config/server.php或config/process.php中的eventLoop未设置，或值为空/拼写错误 - 执行
php --ri swoole确认扩展已启用，且版本 ≥ 5.0（低版本存在协程调度 bug，尤其在高并发 Excel 解析场景下易卡死）
在 config/process.php 中为指定 HTTP 进程开启 Swoole 协程驱动
Webman 允许混合部署：部分端口走传统同步模型，部分端口启用协程。不要全局修改 config/server.php，而应在 config/process.php 中按需开启 —— 这样既能隔离风险，又便于 Nginx 分流。
Webman 2.2.0
下载
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
- 新增一个进程配置块，例如监听
8686端口：return [ 'webman' => [ 'handler' => Http::class, 'listen' => 'http://0.0.0.0:8787', // ... 其他配置保持默认（无 eventLoop → 同步模式） ], 'api-coroutine' => [ 'handler' => Http::class, 'listen' => 'http://0.0.0.0:8686', 'eventLoop' => Workerman\Events\Swoole::class, 'count' => 2, 'constructor' => [...] ] ]; -
eventLoop必须是完整类名字符串，不能写成'swoole'或Swoole::class（后者缺少命名空间） - 该进程启动后，每个请求自动运行在一个独立协程中，无需手动调用
Coroutine::create()包裹整个逻辑
避免在协程上下文中使用阻塞函数，尤其是文件/数据库操作
协程不是多线程，一旦遇到 file_get_contents()、curl_exec()、PDO 同步查询等阻塞调用，整个协程会挂起，拖慢其他并发请求 —— 这比不开启协程还糟糕。
- 必须改用协程友好替代方案：
• 文件读取 →co::readFile()或boxspout流式解析器
• HTTP 请求 →Swoole\Coroutine\Http\Client或hyperf/http-client
• 数据库 →hyperf/database+swoole/mysql协程驱动，或workerman/mysql - 切勿在协程中调用
sleep()，应使用co::sleep()；同理，usleep()→co::usleep() - 第三方 Composer 库若未声明协程安全（如老版本
phpspreadsheet），即使加了go()也无法真正异步，反而造成内存泄漏
协程生命周期与资源释放容易被忽略
Webman 的协程是“请求级”的：每个 HTTP 请求进来时创建，响应发出后销毁。但开发者常误以为协程会自动清理所有子协程或定时器。
- 手动创建的协程（如
go(function () { ... })）若内部有while(true)或长期co::sleep()，会持续占用内存，直到进程重启 - 使用
Timer::tick()或Timer::after()时，必须确保回调能正常退出，否则协程永不结束 - 大文件上传或流式响应场景下，
$request->rawBody()返回的是协程上下文中的内存对象，不可跨协程传递或缓存到静态变量中
