本文详解如何让 php 内置开发服务器响应 `example.com` 域名请求——关键不在 php 命令本身，而在于本地 dns 解析配置；通过修改系统 hosts 文件即可实现无需额外服务的快速域名映射。
PHP 自带的内置 Web 服务器（php -S）不支持虚拟主机（Virtual Host）或基于 Host 头的多域名路由，这意味着你无法通过类似 php -S example.com:8000 的方式直接让它“监听 example.com”。它的 -S 参数仅接受
因此，要让浏览器访问 http://example.com:8000 时实际连接到你的本地 PHP 服务器，核心任务是：让操作系统将 example.com 解析为 127.0.0.1（即本机回环地址）。最简单、跨平台、零依赖的方法是修改本地 hosts 文件。
✅ 正确操作步骤
1. 启动 PHP 内置服务器（绑定到回环地址）
php -S 127.0.0.1:8000 router.php
? 推荐使用 127.0.0.1 而非 localhost（避免 IPv6 解析不确定性） ? router.php 是可选的路由脚本（用于处理静态资源或重写），若暂不需要，可省略
2. 修改系统 hosts 文件，添加域名映射
在终端中执行以下命令（根据操作系统选择对应路径），向 hosts 文件追加一行：
| 系统 | hosts 文件路径 | 添加内容 |
|---|---|---|
| macOS / Linux | /etc/hosts | 127.0.0.1 example.com |
| Windows | C:\Windows\System32\drivers\etc\hosts | 127.0.0.1 example.com |
? 以管理员权限编辑（Linux/macOS 使用 sudo nano /etc/hosts；Windows 用记事本“以管理员身份运行”后打开该文件）。
安装说明重要提醒：程序不支持二级目录安装，请使用一级目录或二级目录绑定!第一步，确定你的服务器支持PHP+mysql。第二步，确定你的服务器开启了gd库。第三步，将upload文件内的文件上传到网站的根目录第四步，访问你的域名+ /install/index.html进行安装，linux系统访问你的域名+ /Install/index.html第五步，按照安装程序步骤进行安装配置第六步，安装完毕后
立即学习“PHP免费学习笔记（深入）”；
保存后，刷新 DNS 缓存（可选但推荐）：
- macOS：sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
- Windows：ipconfig /flushdns
- Linux（systemd-resolved）：sudo systemd-resolve --flush-caches
3. 验证配置
在浏览器中访问：
? http://example.com:8000
应正常加载你的 PHP 应用（端口必须与启动命令一致）。
同时可验证解析是否生效：
ping example.com # 应返回 PING example.com (127.0.0.1) curl -v http://example.com:8000 # 查看 HTTP 响应头与内容
⚠️ 注意事项与常见误区
- ❌ 不要尝试 php -S example.com:8000：会报错 Failed to listen on example.com:8000 (reason: php_network_getaddresses: getaddrinfo failed)，因 PHP 不解析域名作为监听地址。
- ❌ 不要绑定 localhost:80 或 :80（无 root 权限时）：普通用户无法监听 1–1023 端口；建议使用 8000、8080、3000 等高位端口。
- ✅ 若需局域网内其他设备访问（如手机测试），请将监听地址改为 0.0.0.0:8000，并确保防火墙放行该端口；此时仍需在目标设备的 hosts 文件中添加 192.168.x.x example.com（192.168.x.x 为你电脑的局域网 IP）。
- ? example.com 是 IANA 保留的专用示例域名（RFC 2606），不会被真实 DNS 解析，因此修改 hosts 安全且无冲突风险。
? 总结
PHP 内置服务器本质是轻量级开发工具，其设计初衷并非替代 Apache/Nginx 的虚拟主机能力。实现 example.com → 本地服务的关键，在于操作系统层的域名解析控制。hosts 文件方案简洁、可靠、无需安装任何额外软件，是前端/全栈开发者本地多项目域名隔离（如 project-a.test、api.local）的事实标准实践。掌握这一机制，你就能快速为任意自定义域名启用 PHP 开发环境。
