本地PHP环境绑定域名需两步：先修改hosts文件添加127.0.0.1 myapp.test映射，再配置Apache或Nginx虚拟主机指向项目目录，推荐使用.test顶级域并注意权限与缓存问题。
本地 PHP 环境绑定域名，本质是让浏览器访问像 http://myapp.test 这样的地址时，实际指向你电脑上某个项目文件夹（比如 C:\xampp\htdocs\myapp 或 /var/www/myapp），而不是默认的 localhost。这需要两步配合：修改系统 hosts 文件做域名映射，再配置 Web 服务器（如 Apache 或 Nginx）识别该域名并指向对应目录。
一、在 hosts 文件中添加本地域名映射
这是让电脑“认出”你自定义域名的关键一步。所有操作系统都支持：
-
Windows：用记事本（以管理员身份运行）打开
C:\Windows\System32\drivers\etc\hosts -
macOS / Linux：终端执行
sudo nano /etc/hosts
在文件末尾新增一行（IP 地址固定用 127.0.0.1，代表本机）：
127.0.0.1 myapp.test127.0.0.1 api.myapp.test
保存后，命令行执行 ping myapp.test，若返回 127.0.0.1 且能通，说明映射成功。
立即学习“PHP免费学习笔记（深入）”；
二、配置 Web 服务器虚拟主机（以 Apache 为例）
仅改 hosts 还不够——Web 服务器必须知道收到 myapp.test 的请求时，该去哪个文件夹找网页。XAMPP/MAMP/WAMP 默认已启用虚拟主机功能，只需配置：
- 打开 Apache 配置文件：
httpd-vhosts.conf（路径通常为XAMPP\apache\conf\extra\httpd-vhosts.conf） - 在文件末尾添加一个 VirtualHost 块：
ServerName myapp.test
DocumentRoot "C:/xampp/htdocs/myapp"
Require all granted
注意替换路径为你真实的项目位置，并确保 httpd.conf 中这一行已取消注释：
Include conf/extra/httpd-vhosts.conf
重启 Apache，访问 http://myapp.test 就会显示 myapp 文件夹下的内容。
三、Nginx 用户怎么配？（简明版）
如果你用的是 Laragon、Docker 或手动装的 Nginx：
- 编辑
nginx.conf或站点配置文件（如sites-enabled/myapp.conf） - 添加 server 块：
listen 80;
server_name myapp.test;
root /var/www/myapp;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
}
保存后运行 nginx -t 检查语法，再 nginx -s reload 重载配置。
四、小贴士 & 常见问题
- .test 是 IANA 官方保留的本地开发顶级域，推荐使用；避免用 .com/.cn 等真实域名，防止 DNS 冲突
- 浏览器可能缓存 DNS，改完 hosts 后可尝试无痕窗口或清空 DNS 缓存（Windows：
ipconfig /flushdns；macOS：sudo dscacheutil -flushcache） - 如果页面 403，检查 DocumentRoot 路径是否拼写正确、目录是否有读取权限、Apache/Nginx 是否有访问该路径的权限配置
- 想支持 HTTPS？可用 mkcert 工具快速生成本地可信证书，再配置 SSL 模块
