hosts文件用于强制域名解析到指定IP(如127.0.0.1),需按系统路径以管理员/root权限编辑,格式为“IP 域名”,保存后刷新DNS缓存并重启浏览器;配合PHP内置服务器时须绑定0.0.0.0并配置路由脚本。

如果您在本地使用 PHP 运行 Web 项目(例如通过内置服务器 php -S 或集成环境),但浏览器无法正确访问 localhost 或自定义域名,可能是由于域名解析未指向本地。hosts 文件的作用是强制将特定域名映射到指定 IP 地址,常用于绕过 DNS 查询、测试本地开发环境或模拟生产域名。以下是修改 hosts 文件的具体操作方法:
一、理解 hosts 文件的作用
hosts 文件是操作系统维护的静态域名解析表,优先级高于 DNS 服务器。修改它可让浏览器将如 example.test 解析为 127.0.0.1,从而将请求导向本机运行的 PHP 服务。该文件不涉及 PHP 解释器本身,仅影响浏览器对域名的 IP 解析结果。
1、hosts 文件路径因系统而异:Windows 位于 C:\Windows\System32\drivers\etc\hosts;macOS 和 Linux 位于 /etc/hosts。
2、修改前需以管理员(Windows)或 root(macOS/Linux)权限打开文本编辑器。
立即学习“PHP免费学习笔记(深入)”;
3、每行格式为 “IP地址 域名”,中间用空格或制表符分隔,支持注释(以 # 开头)。
4、保存后无需重启系统,但需刷新 DNS 缓存或重启浏览器才能生效。
二、手动添加本地域名映射
此方法适用于希望用自定义域名(如 php.local)访问本地 PHP 项目,而非仅用 localhost:8000。需确保 PHP 内置服务器或 Apache/Nginx 已监听对应端口并配置虚拟主机(若需要)。
1、用记事本(Windows)或 TextEdit(macOS,需设为纯文本模式)或 nano/vim(Linux)打开 hosts 文件。
2、在文件末尾另起一行,输入:127.0.0.1 php.local。
3、保存文件(Windows 用户若提示无权限,需右键记事本选择“以管理员身份运行”后再打开文件)。
4、在终端执行刷新命令:Windows 运行 ipconfig /flushdns;macOS 运行 sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder;Linux(systemd-resolved)运行 sudo systemd-resolve --flush-caches。
5、在浏览器地址栏输入 http://php.local,确认是否能加载本地 PHP 服务响应内容。
三、配合 PHP 内置服务器使用 hosts
PHP 自带的 CLI 服务器(php -S)默认只响应 localhost 和 127.0.0.1,不处理其他域名。若已通过 hosts 将 myapp.test 指向 127.0.0.1,还需在启动时显式绑定 0.0.0.0 或指定路由脚本,否则会返回 404 或拒绝连接。
1、创建一个 router.php 文件,内容为:(最简路由,允许所有路径)。
2、在项目根目录执行:php -S 0.0.0.0:8000 router.php(绑定所有接口,非仅 localhost)。
3、确保 hosts 中存在 127.0.0.1 myapp.test 这一行。
4、浏览器访问 http://myapp.test:8000,此时请求经 hosts 解析为 127.0.0.1,再由 PHP 服务器接收处理。
四、排查 hosts 修改无效的常见原因
即使正确编辑并保存 hosts 文件,仍可能出现浏览器仍跳转至线上网站或显示连接失败的情况,多数与缓存、权限或语法错误有关。
1、检查 hosts 文件末尾是否有隐藏的 BOM 字符或 UTF-8 with BOM 编码——必须保存为 ANSI(Windows)或 UTF-8 without BOM(macOS/Linux)。
2、确认行首无空格、行尾无多余符号,且域名前后无引号或中文标点。
3、验证是否被第三方软件覆盖:某些安全软件、代理工具或网络管理程序会重写 hosts 文件,可临时禁用后重试。
4、在命令行执行 ping myapp.test,观察返回 IP 是否为 127.0.0.1;若不是,说明 hosts 未生效或被覆盖。
5、尝试使用 Chrome 无痕窗口或 Firefox 新建配置文件访问,排除浏览器扩展干扰。











