必须先启动事件循环再初始化DnsResolver,如$loop = Loop::get(); $resolver = (new Factory())->create($loop, '114.114.114.114:53');否则因缺少LoopInterface导致addTimer()调用失败。

ReactPHP 的 DnsResolver 怎么初始化才不报错
直接 new DnsResolver 会失败——它依赖底层 LoopInterface,必须显式传入运行中的事件循环。常见错误是没启动 loop 就调用解析,结果程序静默退出或抛出 Call to a member function addTimer() on null。
- 必须先通过
Loop::get()或Loop::run()获取/启动循环 -
DnsResolver构造时第二个参数是 DNS 服务器地址,默认8.8.8.8:53,国内建议换成114.114.114.114:53避免超时 - 不要在 CLI 脚本末尾漏掉
Loop::run(),否则异步请求根本不会发出
use React\Dns\Resolver\Factory; use React\EventLoop\Loop; $loop = Loop::get(); $resolver = (new Factory())->create($loop, '114.114.114.114:53');
查 A 记录和查 MX 记录的写法差异在哪
类型不同,参数名一样但含义不同:resolve() 第一个参数是域名,第二个参数才是记录类型(字符串),不是布尔值或数字。很多人误以为默认查 A,其实不传类型参数会报错。
- A 记录:用
'A',返回 IPv4 地址数组,如['93.184.216.34'] - MX 记录:用
'MX',返回包含host和priority的对象数组,不是纯字符串 - 查 CNAME 必须显式写
'CNAME',不能依赖重定向——resolve('www.example.com')不会自动跟 CNAME 链
$resolver->resolve('github.com', 'A')->then(
fn ($ips) => var_dump($ips),
fn ($e) => echo "A 查询失败: {$e->getMessage()}"
);
为什么 resolve() 返回 Promise 却不触发 then()
典型表现是脚本跑完没输出、没报错、也没进 then() 或 catch()。根本原因是事件循环没运行,Promise 永远处于 pending 状态。
- Promise 只是注册回调,真正执行靠 loop 驱动;没
Loop::run()就像写了定时器但没启动时钟 - 多个并发查询要共用同一个
$resolver实例,重复 new 会创建冗余 UDP socket,可能触发系统限制 - 超时控制靠
resolve()返回的 Promise 自身不提供 timeout,得用React\Promise\Timer\timeout()包一层
use React\Promise\Timer;
Timer\timeout($resolver->resolve('example.com', 'A'), 3.0, $loop)
->then(fn ($ips) => print_r($ips))
->otherwise(fn ($e) => echo "超时或失败: {$e->getMessage()}");
PHP 8.1+ 下用 ReactPHP DNS 需要留意什么
ReactPHP 2.x 要求 PHP ≥ 7.4,但某些低版本扩展(比如 ext-event)在 PHP 8.1+ 上行为有变,最常踩的坑是 DNS 查询卡住不动,实际是 UDP socket 被阻塞或未正确注册到 loop 中。
立即学习“PHP免费学习笔记(深入)”;
- 确认安装的是
react/dns:^2.0,旧版^1.0不兼容 PHP 8+ - 避免混用
ext-event和ext-libevent,优先用默认的 stream-loop,更稳定 - Windows 下如果遇到
Unable to bind socket,检查是否开了杀毒软件拦截 UDP,或换用 TCP 模式(加?transport=tcp到 DNS 地址后)
异步 DNS 看似简单,但 loop 生命周期、resolver 复用、超时兜底这三处最容易漏掉,少一个就变成“代码写了却没反应”。











