协程需显式启用runtime hook或改用co::函数才能异步；file_get_contents()未被hook导致阻塞卡死；应启用swoole_hook_file或改用co::readfile()；usleep()会阻塞线程，co::sleep()才真正协程化。
协程不会自动变成异步，原生 PHP 的 I/O 函数默认仍是阻塞的；必须显式启用 Runtime Hook 或改用 Co:: 系列函数，才能触发协程切换。
为什么 file_get_contents() 在协程里不并发
它底层调用的是 libc 的 read()，未被 Swoole Hook 拦截，执行时整个协程线程卡死，其他协程无法调度。现象是：启 10 个 go() 调用 file_get_contents()，耗时接近串行叠加，QPS 上不去。
解决路径只有两条：
- 启用文件 I/O Hook：
Swoole\Runtime::enableCoroutine(SWOOLE_HOOK_FILE)（注意：必须在go()前调用，且不能在onWorkerStart里） - 直接换协程安全函数：
Co::readFile()或Co\FileSystem::readFile() - 验证是否生效：用
strace -p $pid -e trace=read,write,epoll_wait观察是否出现大量epoll_wait调用，而非连续阻塞read
Co::sleep() 和 usleep() 的行为差异
前者注册定时器后立即 yield，把控制权交还事件循环，其他协程可运行；后者是 libc nanosleep() 的直连封装，完全阻塞当前线程，调度器彻底失能。
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
常见错误写法：
-
go(function () { usleep(100000); });→ 整个 Worker 卡住 100ms go(function () { for ($i = 0; $i → 正确，每次 yield 后都可能被调度切走- CLI 脚本中漏掉
Co::sleep(0.001)或Swoole\Event::wait()→ 进程退出，协程根本没机会执行
SWOOLE_HOOK_ALL 不等于“全协程化”
它只覆盖 Swoole 自己封装的 socket、DNS、stream 等系统调用层，对以下场景无效：
- 第三方扩展直连 libc（如某些旧版
mysqli、pdo_mysql的底层实现） - C 扩展调用
librdkafka、libcurl等非标准封装库的 I/O - 普通磁盘文件读写（
/proc、/sys等伪文件系统除外）——Swoole 默认不 Hook 普通文件，需手动加SWOOLE_HOOK_FILE - 开启后反而引发兼容问题：比如某些依赖
flock()阻塞语义的代码会失效
真正容易被忽略的点是：协程切换依赖底层 epoll 就绪通知，而普通文件描述符（如 open("/tmp/a.txt") 返回的 fd）压根不支持 epoll 监听——所以即使开了 SWOOLE_HOOK_FILE，Swoole 也得靠线程池模拟异步，此时已不是纯用户态协程调度了。
