coroutinesystem::gethostbyname 是协程安全的 dns 查询函数，表现为“同步写法、异步行为”，调用不阻塞当前协程；而原生 gethostbyname 是阻塞式系统调用，未被 swoole hook，会直接卡住整个 worker 进程。
直接说结论： CoroutineSystem::gethostbyname 是协程安全的 DNS 查询函数，它在协程上下文中表现为“同步写法、异步行为”——调用不阻塞当前协程，但返回结果前会自动让出 CPU 给其他协程；而传统 gethostbyname（或 dns_get_record）在 Swoole 协程环境下若未启用 Hook 或未用协程化替代，会直接阻塞整个进程。
为什么不能直接用原生 gethostbyname
PHP 原生的 gethostbyname 是阻塞式系统调用，底层依赖 libc 的 gethostbyname_r 或类似接口，在 Linux 上会发起同步网络请求（走 /etc/resolv.conf 配置的 DNS 服务器），期间线程完全挂起。在 Swoole 协程服务器中，一旦某个协程调用了它，整个 worker 进程都会卡住，其他协程无法调度——这不是“慢”，是“假死”。
即使你启用了 Runtime::enableCoroutine(SWOOLE_HOOK_ALL)，该函数也不会被自动 Hook，因为它是 PHP 内部函数，不属于 Swoole 默认 Hook 范围（如 fread、curl_exec、mysql_connect 等）。
CoroutineSystem::gethostbyname 的实际行为
这个函数是 Swoole 提供的协程原生 DNS 查询接口，内部使用无阻塞 socket + 自定义 DNS 协议解析（默认 UDP，超时可配），全程不依赖系统解析器。它看起来像同步函数（有返回值），但本质是协程友好的：
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
- 调用后立即返回
null，开始发包； - 若 DNS 响应未就绪，当前协程 yield，让出控制权；
- 响应到达后，协程被唤醒，继续执行并返回 IP 字符串（如
"192.168.1.1"）； - 超时（默认 5s）则返回
false，不会抛异常。
示例：
use SwooleCoroutine;
use SwooleRuntime;
Runtime::enableCoroutine(SWOOLE_HOOK_ALL);
Coroutine::create(function () {
$ip = CoroutineSystem::gethostbyname('github.com');
var_dump($ip); // string(14) "20.205.243.166"
});
常见踩坑点：超时与错误处理
这个函数没有显式超时参数，超时由 swoole.dns.lookup_timeout 配置项控制（默认 5 秒），且无法 per-call 覆盖。容易忽略的问题包括：
- 查询失败时返回
false，不是null或异常，必须用=== false判断； - 传入非法域名（如空字符串、含空格）会直接返回
false，不报 warning； - 若 DNS 服务器本身不可达或防火墙拦截 UDP 53 端口，会静默超时，建议搭配
Coroutine::sleep做兜底重试； - 不支持 IPv6 AAAA 记录查询（截至 Swoole 5.1），只查 A 记录；如需 IPv6，得换
CoroutineDNSClient或自己封装。
真正麻烦的从来不是“怎么写”，而是“为什么写了却还卡住”——比如忘了 Runtime::enableCoroutine()，或者混用了未 Hook 的 cURL 请求。协程不是魔法，它只对明确支持它的函数生效。
