PHPStudy 通过修改系统 hosts 文件绑定域名到 127.0.0.1,并配合 Apache/Nginx 虚拟主机配置实现本地域名访问;需刷新 DNS 缓存、检查端口占用与路径格式,推荐使用 .test 等安全后缀。

PHPStudy 本身不直接处理域名解析,它只是一个集成环境(含 Apache/Nginx、MySQL、PHP),真正的本地域名解析靠的是修改系统 hosts 文件,再配合 PHPStudy 中的虚拟主机(VirtualHost)配置来实现。关键步骤是:改 hosts 绑定域名到 127.0.0.1,再在 PHPStudy 的 Apache 或 Nginx 配置中添加对应站点的虚拟主机规则。
修改系统 hosts 文件,绑定本地域名
这是让浏览器把自定义域名(如 test.local)指向本机的前提:
- Windows 路径:C:\Windows\System32\drivers\etc\hosts(需用记事本或编辑器以管理员身份打开)
- macOS / Linux 路径:/etc/hosts(需 sudo 权限)
- 在文件末尾新增一行,例如:
127.0.0.1 test.local
127.0.0.1 myproject.dev - 保存后,在命令行执行 ipconfig /flushdns(Windows)或 sudo dscacheutil -flushcache(macOS)刷新 DNS 缓存
在 PHPStudy 中配置 Apache 虚拟主机(推荐初学者)
假设你已将项目放在 D:\www\test 目录下,想用 test.local 访问:
- 打开 PHPStudy →「其他选项菜单」→「网站设置」→「Apache 配置」→「打开配置文件 httpd-vhosts.conf」
- 在文件末尾添加如下配置(注意路径和域名与 hosts 一致):
<virtualhost><br> DocumentRoot "D:/www/test"<br> ServerName test.local<br><directory><br> Options Indexes FollowSymLinks<br> AllowOverride All<br> Require all granted<br></directory><br></virtualhost>
- 保存文件,回到 PHPStudy 点击「重启 Apache」
- 浏览器访问 http://test.local,应能正常打开项目
使用 Nginx 配置虚拟主机(若启用了 Nginx)
Nginx 配置逻辑类似,但语法不同:
- 进入 PHPStudy →「其他选项菜单」→「网站设置」→「Nginx 配置」→「打开配置文件 vhost.conf」
- 添加如下 server 块:
server {<br> listen 80;<br> server_name test.local;<br> root "D:/www/test";<br> location / {<br> index index.php index.html error.html;<br> if (!-e $request_filename) {<br> rewrite ^/(.*)$ /index.php/$1 last;<br> }<br> }<br> location ~ \.php(.*)$ {<br> fastcgi_pass 127.0.0.1:9000;<br> fastcgi_index index.php;<br> fastcgi_split_path_info ^((?U).+\.php)(/?.+)$;<br> fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;<br> fastcgi_param PATH_INFO $fastcgi_path_info;<br> fastcgi_param PATH_TRANSLATED $document_root$fastcgi_path_info;<br> include fastcgi_params;<br> }<br>} - 保存后重启 Nginx 即可
常见问题与验证要点
配置失败时优先检查这几项:
- hosts 是否生效:cmd 中执行 ping test.local,看是否返回 127.0.0.1
- 端口是否被占用:默认 80 端口若被 IIS、Skype 或其他程序占了,Apache/Nginx 启动会失败
- 路径大小写与斜杠方向:Windows 下路径用反斜杠 \,但 Apache 配置中建议统一用正斜杠 /(如 D:/www/test)
- PHPStudy 版本差异:新版 PHPStudy(如 8.x)界面更简洁,「网站设置」入口可能在右上角齿轮图标里;旧版(6.x)则在「软件管理」旁的「网站」标签页
- 域名后缀建议:避免用 .com/.cn 等真实顶级域,推荐 .local、.test、.dev(注意 Chrome 对 .dev 强制 HTTPS,建议改用 .test)
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











