安装phpEnv后localhost无法访问？如何解决DNS解析指向::1的难题？

本文共计669个文字，预计阅读时间需要3分钟。

这不是 PHP 或 。

验证很简单：ping localhost 如果返回 ::1（不是 127.0.0.1），且 ping 127.0.0.1 瞬间通，那基本就是它了。

改 hosts 文件是最稳的解法

phpEnv 不干预系统 hosts，但它完全依赖这个映射。只要让 localhost 永远只指向 IPv4，问题就消失。

• 用管理员权限打开 C:\Windows\System32\drivers\etc\hosts（Windows）或 /etc/hosts（macOS/Linux）
• 找到这行：::1 localhost，在前面加 # 注释掉
• 确保这行存在且未注释：127.0.0.1 localhost
• 保存后，在命令行运行 ping localhost，确认只返回 127.0.0.1

改完不用重启电脑，但要重启 phpEnv 的服务（停再启一次 Apache/Nginx 即可）。

立即学习“PHP免费学习笔记（深入）”；

PHP 里用 localhost 失败？别怪函数，怪解析

file_get_contents('http://localhost')、getimagesize()、甚至 PDO 连 MySQL 用 localhost 慢或失败，根源都是 DNS 解析卡在 ::1 上 —— PHP 底层调用 getaddrinfo() 时等超时才 fallback 到 IPv4。

所以不要改 PHP 代码去硬写 127.0.0.1，那只是绕开问题。真正该做的是：

• 先按上一步修好 hosts
• 如果仍不行，检查是否开了 IPv6 隧道或 Teredo（Windows 常见），可用 netsh interface ipv6 show teredo 查看；必要时执行 netsh interface ipv6 set teredo disabled
• 不建议卸载 IPv6（netsh interface ipv6 uninstall），容易引发其他网络异常

phpEnv 自带的 Nginx/Apache 要手动限定监听地址

即使 hosts 改了，如果 phpEnv 的 Web 服务仍监听 [::]:80 或 *:80，某些网络栈行为（比如双栈 socket 创建顺序）仍可能引入微小延迟或偶发失败。

推荐显式绑定 IPv4：

• Apache：编辑 conf/httpd.conf，把 Listen 80 改成 Listen 127.0.0.1:80
• Nginx：编辑 conf/nginx.conf，把 listen 80; 改成 listen 127.0.0.1:80;
• 改完记得重载配置：nginx -s reload 或重启 phpEnv 控制面板

这步做完，localhost 和 127.0.0.1 行为彻底一致，也不用担心未来某次系统更新又悄悄把 ::1 加回去。