php伪静态404主因是nginx未配置重写规则、path_info未传递或root路径错误;需在server块中添加location / { try_files $uri $uri/ /index.php?$query_string; },并确保root指向public目录、fastcgi_param path_info正确设置。

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 进程是否真在监听那个端口。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











