PHP 404 错误本质是 Web 服务器（Nginx/Apache）未找到文件或未将请求转发给 PHP，需先区分“真 404”（服务器未执行 PHP）与“伪 404”（PHP 执行但框架路由失败）；phpEnv 中常见原因包括：Web 服务类型识别错误、.htaccess 未生效或 Nginx vhost 缺失 try_files/rewrite 规则、root 路径未指向 public 目录、PATH_INFO 未配置、修改配置后未彻底重启服务。

phpEnv 里出现 404，基本不是 PHP 自己报的，而是 Nginx 或 Apache 找不到文件或没把请求转给 PHP —— 你得先分清是「真 404」（服务器根本没找到文件）还是「伪 404」（PHP 框架路由没匹配，但服务器其实执行了 index.php）。

确认 phpEnv 当前用的是 Nginx 还是 Apache

phpEnv 启动面板右上角会显示当前启用的 Web 服务类型。这点很关键：

• 如果是 Apache：检查项目根目录下有没有生效的 .htaccess，且 Apache 是否启用了 mod_rewrite；DocumentRoot 是否指向你放 index.php 的目录（比如 D:/phpEnv/www/your-project，不是上层 www）
• 如果是 Nginx：phpEnv 默认用的是 Nginx，但它的配置不自动适配 ThinkPHP、Laravel 等框架的 PATH_INFO 或重写需求，location / 块里必须手动加 try_files 或 rewrite 规则，否则除 /index.php 外所有路径都会被当作静态资源查找，直接 404
• 常见错觉：在 phpEnv 面板点“重启服务”不等于重载配置 —— 修改了 nginx.conf 或 vhost 文件后，必须点「停止」再「启动」，或者命令行执行 nginx -s reload（进 phpEnv 安装目录下的 nginx 子目录操作）

ThinkPHP 在 phpEnv/Nginx 下 404 的典型解法

ThinkPHP（尤其 3.2/5.x）依赖 PATH_INFO 或 index.php?s=xxx 模式解析 URL，而 phpEnv 的 Nginx 默认配置不支持这个。访问 /index.php/Home/Index 报 404，大概率是 Nginx 没把请求交给 index.php。

• 打开 phpEnv 配置 → Nginx → 编辑对应站点的 vhost 文件（路径类似 D:/phpEnv/nginx/vhost/your-site.conf）
• 在 server 块内找到 location /，替换成以下内容（适配 TP5+）：

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

• 如果用的是 TP3.2 且开启 PATH_INFO，还需在 location ~ \.php$ 块里加一行：fastcgi_split_path_info ^(.+\.php)(/.+)$;，并确保 fastcgi_param PATH_INFO $fastcgi_path_info; 存在
• 改完保存，**彻底重启 Nginx**（不是刷新面板），再测 /index.php/Home/Index

验证是不是 PHP 根本没执行（而非框架路由问题）

很多“404”其实是 PHP 没跑起来，浏览器连 phpinfo() 都看不到。快速判断方法：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

立即学习“PHP免费学习笔记（深入）”；

• 在项目根目录新建一个 test.php，内容就一行：<?php echo 'PHP OK'; ?>
• 浏览器访问 http://localhost/test.php：
  • 显示 PHP OK → PHP 解析正常，问题出在路由或重写
  • 下载文件 or 显示源码 → PHP 模块没启用，检查 Nginx 的 location ~ \.php$ 块是否完整，fastcgi_pass 是否指向 phpEnv 自带的 PHP-FPM socket（通常是 unix:/tmp/php-cgi.sock）
  • 返回 404 → 请求压根没进 PHP，Nginx 的 root 路径错了，或者 index.php 不在你设的 root 目录下
• 用命令行进 phpEnv 的 php 目录，运行 php -v 和 php -m | findstr "fpm"（Windows）或 grep fpm（Linux/macOS），确认 PHP-FPM 进程确实在跑

别忽略 phpEnv 的 public 目录陷阱

如果你用的是 Laravel、Lumen 或新版 ThinkPHP，它们要求 Web 服务器的根目录是 public/，不是项目根目录。phpEnv 默认把整个项目目录当 root，结果 index.php 在 public/ 里，Nginx 却去上层找，必然 404。

• 打开 vhost 配置，把 root 改成带 /public 的完整路径，例如：root D:/phpEnv/www/your-laravel-app/public;
• 同时确认 index 指令包含 index.php：index index.html index.htm index.php;
• 别漏掉 location ~ \.php$ 块里的 fastcgi_index index.php;，否则 Nginx 不知道该把请求交给哪个 PHP 文件
• 路径末尾不能多斜杠：root D:/phpEnv/www/app/public/; 是错的，会 404；必须是 root D:/phpEnv/www/app/public;

phpEnv 的 404 很少是代码问题，绝大多数卡在 Nginx 配置和路径映射这层 —— 尤其是改过 vhost 后忘了重启、public 目录没对齐、PATH_INFO 没开这三处，反复踩的人最多。