如何在 PHP 中通过Composer安装 PHP-DNS 库执行底层的 DNS 查询与解析-composer-PHP中文网

php 没有官方维护的 php-dns composer 包，推荐优先使用原生 dns_get_record()（依赖系统配置）或 exec() 调用 dig/nslookup（可控超时、自定义 dns），异步场景可选 react/dns。

如何在 php 中通过composer安装 php-dns 库执行底层的 dns 查询与解析

PHP-DNS 库（dns-packet 的 PHP 移植版）并不存在官方维护的 Composer 包；你搜到的 php-dns 多数是过时、无人维护、甚至无法在现代 PHP（8.0+）运行的项目。直接 composer require 它大概率会失败或引入严重安全/兼容性问题。

为什么找不到可用的 php-dns Composer 包

搜索 php-dns 在 Packagist 上结果极少，且主流结果如 dns-protocol/dns 或 resolv-php/resolv 并非真正“底层 DNS 查询库”，而是 DNS 协议解析器（只解包/打包 DNS 报文），不自带网络传输能力；而真正能发 UDP/TCP 查询的库（如 react/dns）又依赖事件循环，不适合同步场景。

GitHub 上标为 php-dns 的仓库大多最后更新在 2016 年前，PHP 7.4 就已报错
composer require php-dns/php-dns 会提示 “Package not found” 或安装后调用 dns_query 报 Fatal error: Uncaught Error: Call to undefined function
PHP 原生 dns_get_record() 和 gethostbyname() 是最轻量、最可靠的选择——它们调用系统 libc 的 getaddrinfo() 或 res_query()，就是底层 DNS 查询本身

用原生函数替代：dns_get_record() 的正确用法与限制

dns_get_record() 是 PHP 内置函数，无需 Composer，支持 A、AAAA、MX、TXT、CNAME 等常见类型，行为接近 dig/host，但要注意它不走自定义 DNS 服务器，完全依赖系统配置（/etc/resolv.conf 或 Windows DNS 设置）。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

查 A 记录：dns_get_record('example.com', DNS_A)
查 MX + TXT 一起：dns_get_record('gmail.com', DNS_MX | DNS_TXT)
超时不可控——没有 $timeout 参数；若系统 resolver 卡住，PHP 进程会阻塞（默认 5s，由 libc 控制）
不支持指定 nameserver；如需发往 8.8.8.8，必须改系统配置或换方案
返回数组结构扁平，但部分字段（如 class、ttl）可能缺失，取决于系统 resolver 实现

需要自定义 DNS 服务器？用 react/dns（仅限异步场景）

如果你真要绕过系统 resolver、直连特定 DNS 服务器（如 1.1.1.1），且项目已用 ReactPHP 或可接受事件循环模型，react/dns 是目前唯一活跃、可靠的选项。

安装：composer require react/dns

基础用法（需 EventLoop）：

$loop = React\EventLoop\Factory::create();
$dnsFactory = new React\Dns\Resolver\Factory();
$resolver = $dnsFactory->create('8.8.8.8:53', $loop);

$resolver->resolve('github.com')->then(function ($ip) {
    echo $ip . "\n";
});

$loop->run();

不支持同步阻塞调用；强行在普通 CLI 脚本里用会卡死——必须配合 react/event-loop
对简单脚本是杀鸡用牛刀；若只是偶尔查几个域名，不如用 shell 调 dig @8.8.8.8 example.com A +short 并 exec()

绕过 PHP 层：用 exec() 调用 dig / nslookup（最稳的 fallback）

当你要精确控制 DNS 服务器、协议（TCP/UDP）、超时、重试，且不能引入事件循环时，调用系统 dig 是最可控的方式。它本质就是 PHP 执行底层 DNS 查询的“外挂接口”。

查 A 记录并只取 IP：exec("dig @8.8.8.8 example.com A +short", $output); $ip = $output[0] ?? null;
加超时防卡死：exec("timeout 3 dig @1.1.1.1 example.com AAAA +short 2>/dev/null", $output);
注意 Windows 下用 nslookup，且语法不同；建议封装判断 OS 或统一用 dig（需提前装好）
输出需清理换行和空格；trim(implode('', $output)) 比直接取 $output[0] 更安全
生产环境需验证 dig 是否存在、是否被禁用（某些共享主机屏蔽 exec 函数）