本地 PHP 环境无法用域名访问，本质上是域名解析、Web 服务器路由和 PHP 权限三方没对齐，只要把 hosts 文件里的域名指向 127.0.0.1、在 Apache 或 Nginx 中给这个域名配置独立的虚拟主机，并确认 php.ini 的 doc_root 不会拦截请求，绝大多数问题能一次性解决。
本地PHP环境无法用域名访问的常见原因
很多人在本地用 phpStudy、WAMP 或 XAMPP 建站时，习惯在浏览器里输入 localhost/项目名 访问代码，等到想把站点绑定到某个自定义域名，php.test，却发现怎么弄都跳转失败，这里最容易被忽略的，不是代码问题，而是三个配置节点没有同步完成。
hosts 文件里没有这个域名
浏览器输入域名后,第一步是向操作系统请求解析这个域名对应的 IP，Windows 系统会先查 C:\Windows\System32\drivers\etc\hosts，Linux 和 macOS 则查 /etc/hosts，如果这个文件里没有你写的域名，请求就会走向真实的公共 DNS 服务器，自然找不到你本机的项目。
操作上,用管理员身份打开 hosts 文件，在末尾追加一行：
0.0.1 php.test
保存后,可以先在命令行里执行 ping php.test，看到回包 IP 为 127.0.0.1，说明系统解析这关已经通过，常见的小坑是：Windows 10 和 Windows 11 的 hosts 文件默认是只读状态，你用普通编辑器保存时会提示权限不足，实际上没写进去。
PHP 的 doc_root 参数锁死了请求路径
PHP 配置文件 php.ini 里有一个 doc_root 参数，很多旧教程建议新手把项目路径填进去，结果反而造成新问题。doc_root 的本意是限定 PHP 只处理该目录下的文件，一旦这个参数被设置为某个具体目录，它会对 Web 服务器转发过来的所有 PHP 请求做一次路径检查，域名绑定得再完美，请求路径不落在 doc_root 范围内就会被拒绝。
业内专家指出,在 PHP 5.3 之后，这个参数对多数集成环境来说已经没有存在感，默认留空即可，如果你以前手动改过 doc_root，请打开 php.ini，找到这一行，把它改成空值，然后重启 PHP 服务。
Web 服务器没有给域名建虚拟主机
hosts 文件能把域名解析到本机，但真正接收请求的是你的 Web 服务器软件，Apache 收到一个 HTTP 请求后，会在配置文件里寻找 ServerName 与请求域名匹配的虚拟主机块，找不到匹配项时，就落到默认站点，这也就是为什么你经常看到输入 php.test，打开的却是 localhost 首页或 XAMPP 欢迎页。
行业共识认为,无论 Apache 还是 Nginx，虚拟主机定义的匹配顺序会影响最终生效结果，把具体域名写在配置最前端，能减少这类靠“默认站点兜底”引发的问题。
phpStudy配置域名访问的完整操作流程
phpStudy 是国内使用率很高的 Windows 集成环境，它的面板界面在多个版本里不太一样，但配置思路保持一致，下面这套流程适用于 2018 版之后的大多数 phpStudy。
第一步：确认项目根目录路径
在操作之前,先明确你的项目目录放在哪。D:\www\demo，这个路径后面要反复用到，别临时去资源管理器里翻，容易把长短路径搞混。
第二步：添加域名到 hosts 文件
打开 hosts 文件，把域名写进去，这一步大多数 phpStudy 面板已经做成自动化，你在“创建站点”时勾选“写入 hosts”，它会帮你操作，如果你用的版本没有这个选项，就手动执行上文提到的方法。
第三步：在面板里创建站点并绑定根目录
打开 phpStudy 控制面板，进入“网站”菜单，点击“创建站点”：
- 域名：填
php.test - 端口：
80 - 根目录：选
D:\www\demo - PHP 版本：保持默认或选择你项目需要的版本
保存后,phpStudy 会自动生成对应的 Apache 或 Nginx 虚拟主机文件。
第四步：检查 phpStudy 自动生成的 vhosts 配置
很多人在面板操作完,直接输入域名还是 404，原因在于面板生成的配置和实际项目路径不匹配，Apache 的配置文件一般位于 D:\phpStudy_Pro\Extensions\Apache2.4.39\conf\vhosts.conf（具体路径随安装位置变化），打开它，你应该能看到类似这样的块：
<VirtualHost :80>
ServerName php.test
DocumentRoot "D:\www\demo"
<Directory "D:\www\demo">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>DocumentRoot 指向的目录不存在，或者 <Directory> 后面的路径填错了，浏览器就会报 404，请逐一对比路径是否和你的项目目录完全一致。
第五步：重启 Apache 或 Nginx
改完配置后,必须重启 Web 服务器，phpStudy 面板里点击“重启”按钮即可，有些版本需要先停止再启动，建议你重启后观察左下角提示，出现绿色的“已启动”状态再测试域名。
手工搭建Apache和Nginx环境，配置域名访问有哪些不同
如果你不是用集成面板,而是手工搭建的本地 PHP 环境，域名配置方式会有些差别。
Apache 的手工配置路径
Apache 的虚拟主机配置文件通常在 安装目录/conf/extra/httpd-vhosts.conf，有些发行版会要求先在主配置文件 httpd.conf 中解除这一行的注释：
Include conf/extra/httpd-vhosts.conf然后在这个文件里按照上面的 <VirtualHost> 格式添加你的域名块，添加完后，执行 httpd -t 检查语法，看到 Syntax OK 再重启服务。
Nginx 的核心配置块
Nginx 的配置在 nginx.conf 或 conf.d 目录下的站点配置文件中，写法风格完全不同：
server {
listen 80;
server_name php.test;
root D:/www/demo;
index index.php index.html;
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}server_name 就是你要绑定的域名，root 是项目根目录，PHP 请求会被转发给 FastCGI 进程，fastcgi_param 里的 $document_root 必须与 root 一致，否则 PHP 文件会被当成静态文件返回或直接报错。
两个服务器的侧重点不同,Apache 的 <Directory> 能够直接控制目录访问权限，Nginx 则用 location 区块配合 fastcgi_pass 来分发请求，Apache 的写法更接近直觉，Nginx 则要理解“请求匹配”的概念。
| 对比项 | Apache | Nginx |
|---|---|---|
| 虚拟主机配置入口 | httpd-vhosts.conf | nginx.conf 或 conf.d 下站点文件 |
| 域名绑定关键词 | ServerName | server_name |
| 根目录指定 | DocumentRoot | root |
| PHP 请求分发 | 通过 PHP 模块或 CGI | fastcgi_pass 转发到 PHP-FPM |
| 路径权限控制 | <Directory> 指令 |
location 块 + 访问规则 |
本地域名配置后常见的404、403和500错误
配置完成后,域名依然打不开的报错类型，通常能直接反映问题出在哪一个环节。
404：目录对不上或域名没进 hosts
404 代表浏览器找到了服务器，但服务器没有找到对应的资源，首选检查 DocumentRoot 或 root 指定的路径下，是否存在 index.php，其次检查 hosts 文件，如果你在本机配置好了，但浏览器一直显示 404，也可以在命令行执行 curl -H "Host: php.test" http://127.0.0.1，直接向服务器发送带有域名的请求，看返回结果是否正常。
403：目录权限不足
403 语义是“禁止访问”，多数情况下是 Apache 的 <Directory> 块没有开启 Require all granted，或者 Nginx 的运行用户没有读取项目目录的权限，Windows 下还要确认项目目录的“安全”选项卡中，Users 组至少勾选了“读取和执行”，有时候你把项目放在 C 盘 Program Files 下，这类系统保护目录默认不让其他用户读取，就会触发 403。
500：php.ini 冲突或 PHP 扩展缺失
500 属于服务器内部错误，和域名绑定本身关系不大，常见原因是 PHP 代码里使用了 <? 短标签，而 php.ini 的 short_open_tag 为 Off，导致解释器直接把整段代码当文本输出，更隐蔽的一种情况是你同时改过 doc_root 和 open_basedir，这两个参数叠加后，PHP 只能读取极小范围的目录，项目里一旦有引入外部文件的操作，立即抛错。
排查时,打开 phpStudy 的日志目录，找到 Apache 的错误日志，溢出信息会直接告诉你落在哪个文件第几行。
Q&A：PHP配置域名访问的典型问题
配置好本地域名后，同一局域网内的其他电脑也想访问，应该改哪里？
把其他电脑的 hosts 文件里加上你本机局域网 IP 的映射，格式是 168.x.x php.test，注意不是 127.0.0.1，同时保证本机防火墙放行 80 端口，Web 服务器监听地址是 0.0.0 而不是 0.0.1，并且你的项目代码中数据库连接主机的地址已改为局域网 IP 或域名，而不是 localhost。
phpStudy 新版面板中，Apache 和 Nginx 切换后域名失效是什么情况？
Apache 和 Nginx 使用各自独立的虚拟主机配置文件，切换服务时 phpStudy 不会自动迁移站点配置，切到 Nginx 后，你需要重新在面板里检查一遍站点列表，并到 Nginx 的 vhosts.conf 中确认 server_name 和 root 是否完好，多数情况下，失败是因为你之前只在 Apache 侧配置了虚拟主机，Nginx 侧没有对应站点块。
配置域名后，刷新浏览器还是打开 localhost 的内容，究竟卡在哪一步？
这是最典型的问题,先做一次干净测试：关闭浏览器所有标签页，重新打开后直接输入 http://php.test，如果仍然访问到 localhost，说明 Web 服务器的虚拟主机没有读取到你的新配置，检查 Apache 的 httpd.conf 里是否包含 Include conf/extra/httpd-vhosts.conf，或者 Nginx 的 include 指令是否指向了你放置配置文件的目录。
本地 PHP 环境无法用域名访问的根源，始终落在 hosts 解析、虚拟主机绑定和 PHP 路径权限这三步链路上，顺着配置顺序逐项排查，一般十分钟内能定位到具体拦截点。