Docker容器中PHP gethostbyaddr返回IP而非主机名的问题

gethostbyaddr 函数本身不内置解析逻辑，完全依赖操作系统层面的DNS解析能力：当反向PTR记录解析失败时，函数会无提示返回传入的原始IP地址，不会抛出显性错误。你遇到的问题本质和PHP无关，是Docker容器的DNS解析链路和WSL宿主机存在配置差异，导致反向解析请求无法正常返回结果。

• 第一步：对比宿主机与容器的DNS配置
  1. 在WSL环境执行 cat /etc/resolv.conf，记录文件内所有可用的nameserver地址，这些地址是当前WSL下能正常跑通host反向解析的可信DNS源。
  2. 进入正在运行的Docker容器，同样执行 cat /etc/resolv.conf 查看配置：多数场景下你会发现容器内的默认DNS是Docker内置的转发地址127.0.0.11，而非和WSL一致的可用DNS。
• 第二步：临时验证问题
  手动修改容器内的/etc/resolv.conf，把nameserver值替换成WSL里记录的可信DNS地址，保存后立刻在容器内执行 host 66.249.66.1，如果此时能正常返回对应的PTR记录，即可确认问题完全出在DNS配置上。此时再运行你的PHP示例代码，就能看到gethostbyaddr正常返回对应的谷歌机器人域名，不需要修改任何PHP配置。
• 第三步：固定配置长期生效
  有三种常用方式可以让容器永久使用正确的DNS配置，无需每次手动修改：
  1. 启动容器时手动指定DNS参数：在docker run命令中追加--dns <可信DNS地址>参数，Docker会跳过内置的DNS转发逻辑，直接把指定的DNS写入容器的/etc/resolv.conf。
  2. 使用docker-compose编排服务时，在对应服务的配置块下新增dns字段，列出所有可用的可信DNS地址，配置格式示例：

     services:
       your-php-service:
         image: 你的PHP镜像
         dns:
           - 192.168.3.1
           - 223.5.5.5
     

  3. 修改Docker全局守护进程配置：编辑WSL内的/etc/docker/daemon.json，新增dns字段填入可信DNS地址，保存后执行sudo systemctl restart docker重启Docker服务，后续所有新启动的容器都会自动应用这套DNS配置。

• 不要盲目直接填8.8.8.8、114.114.114.114这类公共DNS作为容器的DNS地址：反向解析的返回结果和网络出口、DNS节点位置强相关，只有WSL内实测能正常返回PTR记录的DNS地址，给容器用才会生效。
• 不要把问题往PHP层面排查：只要容器底层执行getent hosts 66.249.66.1命令能正常返回域名，PHP的gethostbyaddr不需要任何修改就能直接拿到正确结果。

内容的提问来源于stack exchange，提问作者PapaSku