phpEnv配置Nginx隐藏index.html phpEnv默认文档设置-php教程-PHP中文网

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

phpenv配置nginx隐藏index.html phpenv默认文档设置

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 前面：

anything-to-html

将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 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 时用了自定义参数和工作路径