Swoole中Hook函数的范围及限制

先说说几个核心判断：Swoole 的 Hook 机制虽然强大，但并不是万能的。它本质上是“函数级替换”——只覆盖那些明确注册过的 PHP 函数入口，对于那些绕过 PHP 层、直接调用系统调用的 C 扩展逻辑，它其实无能为力。理解这一点，很多困惑就能迎刃而解。

SWOOLE_HOOK_TCP 覆盖哪些函数？

简单来说，它只管 PHP 流层的 TCP 相关操作。你可能会问，它到底管哪些？Cheat sheet 在这里：fsockopen()、stream_socket_client()、stream_socket_server()、stream_select()、fread()、fwrite()、fgets()，以及 file_get_contents('http://...') 这类带上网络协议头的调用，都在它的覆盖范围内。

但注意，file_get_contents('/tmp/a.txt') 不在此列——路径是本地文件，走的是系统 I/O，得靠专门的 SWOOLE_HOOK_FILE 来处理。换句话说，它不碰系统调用，也不碰那些不走 PHP 流层的 C 扩展直连逻辑。

• 像 Guzzle 这类 HTTP 请求库，底层依赖的是 stream_socket_client()，所以必须开启 SWOOLE_HOOK_TCP。
• 但 curl_exec() 完全不走流层，哪怕你开了 SWOOLE_HOOK_TCP，它也是“刀枪不入”的。
• 还有一点，某些老版本的 PDO 在预处理模式下，仍然直接调用 read() 函数，这种时候 Hook 也进不去。

SWOOLE_HOOK_CURL 和 SWOOLE_HOOK_NATIVE_CURL 的区别

这两个标志经常让人迷糊。其实很简单：SWOOLE_HOOK_CURL 针对的是 PHP 标准 cURL 扩展（也就是 curl_init() + curl_exec() 这套）；而 SWOOLE_HOOK_NATIVE_CURL 是 Swoole 6.0+ 之后引入的新人，它启用的是 Swoole 内置的协程版 cURL 实现——前提是，编译时必须开启 --enable-swoole-curl。

关键点来了：两者是互斥的。如果你启用了 SWOOLE_HOOK_NATIVE_CURL，那么 curl_exec() 会自动走 Swoole 自研的协程客户端，性能更好，可控性也更强。但如果你没开那个编译选项，设置这个标志就会静默失效，什么都不会发生。

那么生产环境怎么选？看这里：

• 推荐组合：SWOOLE_HOOK_ALL | SWOOLE_HOOK_CURL，兼容性最好，稳妥。
• 如果你确认已经编译时开启了 --enable-swoole-curl，可以改用 SWOOLE_HOOK_ALL | SWOOLE_HOOK_NATIVE_CURL，能获得更好的性能。
• 但千万别把这两个 cURL 标志混在一起用，结果可能你看不懂。

Co::set() 和 Runtime::enableCoroutine() 哪个该用？

这个问题问的人很多。两者在功能上是等价的，但使用场景和限制完全不同。

Co::set() 必须放在协程上下文中调用，也就是说，它只能在 Corun() 里面、所有 go() 之前执行。一旦你在主进程或者某个子协程里乱调，就会直接报错：“Invalid argument: Co::set() must be called in coroutine”。

相比之下，Runtime::enableCoroutine() 就友好得多。它可以在任意位置调用（包括主进程），只要在协程启动前完成就行。而且它是全局生效的——后续创建的所有协程都会继承这个配置。

• 新项目建议统一用 Runtime::enableCoroutine(SWOOLE_HOOK_ALL)，省心省力。
• 如果是旧项目迁移，里面已经有 Co::set() 了，那要检查一下：它有没有被误放在 go() 回调里？如果有，部分协程可能根本没被 Hook 到，会出大问题。
• 还有一个容易被忽视的坑：多线程环境下，Swoole 6.1.3 起强制要求 Hook 只能在主线程初始化，在子线程里调用会直接触发内存越界。

为什么有些阻塞调用怎么 Hook 都不协程化？

这可能是开发者最头疼的问题。明明开了所有 Hook，为什么还是卡住了？

根本原因刚才已经说了：Swoole 的 Hook 是“函数级替换”，它只覆盖明确注册过的 PHP 函数入口。它无法干预那些绕过 PHP 层、直接调用 read()/write() 的 C 扩展逻辑。常见的“漏网之鱼”包括：

• 部分 Redis 扩展（比如 phpredis）在 pipeline 模式下，仍然使用同步 socket。
• 某些 PDO 驱动在 prepare 阶段，并没有走 PHP 流层，而是直接连接了 MySQL 协议。
• 还有一些自定义扩展，里面硬编码了 fopen() 或 usleep() 调用。

对于这些情况，你只有两个选择：要么换成专用的协程客户端（比如 swoole_redis、swoole_mysql），要么把它们隔离到子进程里处理。不能指望 Hook 能解决所有问题。

最后提醒一个最容易踩的坑：即使你开了 SWOOLE_HOOK_ALL，sleep() 默认也不协程化。除非你显式加上 SWOOLE_HOOK_SLEEP，或者直接改用 co::sleep()——后者更安全，因为它不依赖 Hook 状态。