PHPEnv修复Nginx404与伪静态问题

本文深入解析了使用phpEnv搭建PHP开发环境时Nginx频繁返回404的三大核心原因：伪静态规则缺失导致路由无法重写、PATH_INFO未正确传递致使ThinkPHP等框架路由失效，以及root路径配置错误使入口文件不可达；通过精准修改vhosts配置中的location块、补充fastcgi_param设置、严格校准root指向public目录，并结合error.log实时排查，手把手教你一次性根治“首页正常、子页面全404”的顽疾，让Laravel、ThinkPHP、WordPress等主流框架真正跑起来。

phpEnv 的 Nginx 配置里没加伪静态规则

phpEnv 默认不自动注入框架所需的重写逻辑，哪怕你装了 Laravel、ThinkPHP 或 WordPress，nginx.conf 或站点对应的 vhosts.conf 文件里若没手动补上 location / 块和 try_files（或 rewrite），Nginx 就只会按路径找物理文件——找不到就直接返回 404。

常见错误现象：首页能打开（因为匹配到 index.php），但点「关于我们」「/admin/user」这类路由就 404；curl -I http://localhost/about 返回 404 Not Found，而 http://localhost/index.php/about 却正常。

实操建议：

• 打开 phpEnv 面板 → 设置 → vhosts.conf → 找到你当前启用的站点配置文件（如 www.test.com_80.conf）
• 在 server { ... } 块内、root 指令下方插入以下标准 location / 块（选一种即可，别混用）：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

或者 ThinkPHP/Laravel 旧版兼容写法（需确保 PHP 正确解析 PATH_INFO）：

location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=$1 last;
    }
}

改完务必执行 nginx -s reload（phpEnv 面板里点「重启 Nginx」也行，但要确认它真执行了 reload 而非 restart）。

fastcgi_param PATH_INFO 未设置导致 ThinkPHP 路由失效

ThinkPHP 3.2/5.x/6+ 默认依赖 $_SERVER['PATH_INFO'] 解析 URL 中的模块/控制器/方法。Nginx 默认不传这个变量，即使伪静态规则把请求转到了 index.php，PHP 里 $_SERVER['PATH_INFO'] 仍是空，框架就认为路由不存在，最终抛出 404。

这不是 phpEnv 的 bug，是 Nginx + PHP-FPM 的协作盲区。

实操建议：

• 在站点配置的 location ~ \.php(.*)$ 块内，确认包含这两行（缺一不可）：

fastcgi_split_path_info ^((?U).+\.php)(/?.+)$;
fastcgi_param PATH_INFO $fastcgi_path_info;

同时保留标准的 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;；否则 $fastcgi_path_info 会取不到值。

注意：fastcgi_split_path_info 正则必须严格匹配你的 URL 结构，比如 /index.php/v1/user/list 能拆出 /v1/user/list，但 /v1/user/list（无 index.php）就不适用——这正是为什么推荐优先用 try_files + $query_string 方案。

phpEnv 的 root 路径指向 public 目录外层

很多用户把项目整个丢进 D:\phpEnv\www\myapp\，然后在配置里写 root D:/phpEnv/www/myapp;。结果 Nginx 直接暴露了 application/、config/ 等敏感目录，更关键的是——入口文件 index.php 不在 Web 可访问根下，或被放在子目录（如 public/）里却没正确映射。

典型表现：http://localhost/index.php 404，或报错 No input file specified.。

实操建议：

• 确认你的框架实际入口是哪个文件（Laravel 是 public/index.php，ThinkPHP 6+ 是 public/index.php，老版本可能是根目录的 index.php）
• 把 root 指向该入口文件所在目录，例如：

root D:/phpEnv/www/myapp/public;（Laravel/TP6）

root D:/phpEnv/www/myapp;（TP3.2 或自定义结构）

别漏掉末尾斜杠，也别写成 D:\phpEnv\www\myapp\public\（Windows 下反斜杠在 Nginx 配置里可能被误解析）。

修改后仍 404？先看 error.log 而不是瞎猜

phpEnv 的 Nginx 错误日志默认在 D:\phpEnv\nginx\logs\error.log（Windows）或 /usr/local/phpenv/nginx/logs/error.log（Linux/macOS）。90% 的“改了没用”问题，日志里第一行就写了原因。

常见线索：

• directory index of "/D:/phpEnv/www/myapp/" is forbidden → index 指令缺失或 autoindex on 被禁用，但更可能是 root 路径错了
• open() "/D:/phpEnv/www/myapp/index.php" failed (2: No such file or directory) → root 没指向含 index.php 的目录
• FastCGI sent in stderr: "Primary script unknown" → SCRIPT_FILENAME 构造错误，通常因 $document_root 和实际路径不一致

每次改完配置，先 tail -f D:\phpEnv\nginx\logs\error.log（Windows 可用记事本实时打开），再刷新页面——错误信息比你凭空想的条件更准。

最易被忽略的一点：phpEnv 的「重启 Nginx」按钮有时只 reload，有时会 full restart；如果之前启用了多个 PHP 版本，且 fastcgi_pass 指向了已停用的端口（如 127.0.0.1:9001），reload 不会自动修正，得手动检查 php-fpm 进程是否真在监听那个端口。

文中关于phpenv的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHPEnv修复Nginx404与伪静态问题》文章吧，也可关注golang学习网公众号了解相关技术文章。