Swoole 4+ 支持异步 DNS 解析，协程方式用 Swoole\Coroutine\System::dnsLookup() 自动挂起恢复，传统方式用已废弃的 swoole_async_dns_lookup() 回调处理；需确保协程环境、有效 DNS 配置及合理超时。
Swoole 4+ 版本已原生支持异步 DNS 解析，无需依赖系统 gethostbyname 或外部命令，全程在事件循环内非阻塞完成，避免 Worker 进程被卡住。关键在于使用 Swoole\Coroutine\System::dnsLookup()（协程方式）或 swoole_async_dns_lookup()（传统异步回调方式），二者适用场景不同，需按运行模型选择。
协程方式：推荐用于 Swoole 协程环境（如 Webman、Hyperf、自建协程服务器）
在已启用协程 Hook（Swoole\Runtime::enableCoroutine()）或明确处于协程上下文时，直接调用 Swoole\Coroutine\System::dnsLookup() 最简洁高效。它会自动挂起当前协程，由 Swoole 底层通过 getaddrinfo 异步完成解析，完成后恢复协程执行。
- 语法简单：
$ip = Swoole\Coroutine\System::dnsLookup('www.example.com', 5);，第二个参数为超时秒数（可选，默认 5） - 返回字符串 IP 地址（如
"93.184.216.34"），失败时返回false - 支持 IPv4/IPv6 双栈，自动优先返回可用地址；若需指定协议，可传第三个参数
AF_INET或AF_INET6 - 注意：不能在 CLI 同步脚本或未启动协程的环境中直接调用，否则报错
传统异步方式：适用于非协程 Server（如旧版 Swoole\Http\Server + 回调风格）
若项目仍基于回调式 Server（未全面协程化），可用 swoole_async_dns_lookup()。它不阻塞进程，但需显式提供成功/失败回调函数。
- 基本用法：
swoole_async_dns_lookup('www.example.com', function($domain, $ip) { echo "Resolved: {$domain} → {$ip}\n"; }); - 失败时回调的
$ip为false，可通过swoole_last_error()查看错误码 - 该函数是全局异步任务，不受协程调度影响，适合混搭场景，但无法用
yield或await等待结果 - 注意：PHP 8.0+ 中该函数已被标记为废弃，建议新项目统一转向协程方式
常见问题与避坑点
实际使用中容易忽略底层限制和配置细节：
-
DNS 服务器配置必须有效：Swoole 默认读取系统
/etc/resolv.conf，若容器或云环境未正确挂载或覆盖，会导致解析失败。可手动指定：Swoole\Coroutine\System::setDnsServer(['8.8.8.8', '114.114.114.114']); - 超时设置要合理：公网 DNS 延迟波动大，设过短（如 0.5s）易误判失败；设过长（如 10s）拖慢整体响应。生产建议 2–5 秒区间
-
不要在协程外调用协程函数：例如在
onWorkerStart回调里直接调dnsLookup会报 “must be called in coroutine” 错误。应改用go(function () { ... })包裹 -
批量解析需串行或并发控制：协程方式本身不支持批量域名一次性查，需用
go+WaitGroup并发发起，或循环调用。避免无节制创建协程导致内存压力
不复杂但容易忽略：只要确认运行在协程环境、DNS 配置可达、超时留有余量，dnsLookup 就是开箱即用的可靠方案。
