Nginx隐藏index.html配置教程

本文详解了在 Windows 下使用 phpEnv 配置 Nginx 以隐藏 index.php（而非 index.html）的关键步骤与常见陷阱，涵盖默认首页优先级调整、try_files 规则的双位置精准配置、root 目录必须指向 public 子目录、PATH_INFO 支持的启用方式，以及最易被忽视却至关重要的“仅通过 phpEnv 控制面板重启 Nginx 才生效”这一核心限制——帮你避开因配置路径特殊、重载机制封闭导致的反复 404 和无效修改，真正实现 ThinkPHP、Laravel 等框架的优雅 URL 路由。

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

• 打开 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 里。

本篇关于《Nginx隐藏index.html配置教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！