隐藏index.php需配置phpEnv中Nginx的vhost文件:修改default.conf,location/块加try_files规则,location~.php$块配对使用try_files,并确保root指向public目录,最后通过phpEnv控制面板重启Nginx生效。

phpEnv 是 Windows 下的轻量级 PHP 开发环境套件,内置 Nginx、PHP 和 MySQL。它默认用 index.html 作首页,但很多 PHP 项目(如 ThinkPHP、Laravel)依赖 index.php 入口,且需隐藏 index.php 实现美观 URL。问题核心不是“怎么设默认文档”,而是:Nginx 在 phpEnv 中的配置位置特殊、reload 方式受限、且默认不启用重写支持。
phpEnv 的 Nginx 配置文件在哪
phpEnv 把 Nginx 配置拆成主配置 + 虚拟主机配置,实际生效的是:
- 主配置:
C:\phpEnv\nginx\conf\nginx.conf - 站点配置:
C:\phpEnv\nginx\vhost\default.conf(或你自定义的xxx.conf)
⚠️ 注意:修改后不能直接用 nginx -s reload —— phpEnv 自带的“重启 Nginx”按钮才真正 reload,否则改了也不生效。
如何设置默认文档为 index.php 优先
Nginx 默认按 index 指令顺序查找首页文件。你要确保 index.php 排在 index.html 前面:
立即学习“PHP免费学习笔记(深入)”;
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
- 打开
C:\phpEnv\nginx\vhost\default.conf - 找到
location / {块,在里面确认有这行:index index.php index.html index.htm;
- 如果没有,就加进去;如果已有但顺序是
index.html index.php,就调换位置
这个改动只影响“访问目录时自动选哪个文件”,不解决 URL 中出现 index.php 的问题。
怎么真正隐藏 index.php(ThinkPHP/Laravel 类框架)
隐藏 index.php 的本质是:把所有非静态资源请求,都 fallback 到 index.php 处理。在 phpEnv 中必须同时改两处:
-
location /块里加try_files规则 -
location ~ .php$块里也要配对使用try_files(否则 PHP 路由仍 404)
正确写法(放在 default.conf 的 server 块内):
location / {
try_files $uri $uri/ /index.php?s=$uri&$args;
}
location ~ \.php$ {
try_files $uri =404;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}-
$uri =404是关键:它让 Nginx 不再尝试找物理存在的.php文件,而是直接交给 PHP-FPM;没这句,/user/list这种路由会 404 -
s=$uri是 ThinkPHP 5/6 的标准传参方式;Laravel 则常用/index.php/$uri,取决于你框架的路由模式
容易被忽略的三个坑
-
root路径必须指向项目public/目录(例如root "C:/www/myapp/public";),而不是项目根目录。否则$document_root/index.php会 404 -
phpEnv自带的enable-php-pathinfo.conf文件默认未加载,如果你用 PATH_INFO 模式(如旧版 ThinkPHP),得手动在location ~ .php$块里include它 - 修改配置后,必须点 phpEnv 控制面板里的「重启 Nginx」按钮,命令行执行
nginx -s reload无效,因为 phpEnv 启动 Nginx 时用了自定义参数和工作路径
真正的难点不在规则本身,而在于 phpEnv 封装了底层控制权——你以为改完保存就 ok,其实 reload 这一步卡在 GUI 里。


















