phpenv 的 nginx 配置入口是通过「环境管理器」点击站点→「配置」→「nginx 配置」打开的 site_80.conf 文件，位于 c:\phpenv\config\nginx\conf.d\ 下，所有 error_page 和 location 配置必须写于此处。
phpEnv 是 Windows 下集成 Nginx + PHP 的轻量环境，它默认不启用 error_page 功能，且配置文件路径、权限、PHP 处理链路与标准 Nginx 有差异。直接套用通用教程大概率失败——关键在于 phpEnv 的 Nginx 配置被封装在「环境管理器」生成的 conf 文件中，且 PHP-FPM 通信方式固定为 TCP（非 Unix socket），fastcgi_intercept_errors 必须显式开启才能捕获后端错误。
确认 phpEnv 的 Nginx 配置入口在哪
phpEnv 的主 Nginx 配置不是直接编辑 nginx.conf，而是通过「phpEnv 环境管理器」界面操作：点击对应站点 → 「配置」→「Nginx 配置」，它会打开一个由 phpEnv 自动生成的独立配置片段（如 site_80.conf），该文件位于 C:\phpEnv\config\nginx\conf.d\ 下。所有 error_page 和 location 配置必须写在这里，而非全局 nginx.conf；否则 reload 时会被覆盖或忽略。
404 / 502 页面必须加 internal + 显式 root
phpEnv 默认的 root 路径是 C:/phpEnv/www/，但 error_page 指向的 HTML 文件路径是相对于这个 root 的。常见错误是把 /404.html 放错位置，或漏掉 internal 导致循环 404：
-
error_page 404 /404.html;中的/404.html必须存放在C:/phpEnv/www/404.html - 必须配对添加
location = /404.html { internal; root C:/phpEnv/www; }—— 注意root值不能省略，也不能写成/www或相对路径 - 若想为不同站点设不同错误页（如
site-a用/site-a/404.html），则root要改为C:/phpEnv/www/site-a，且error_page改为error_page 404 /404.html;（路径仍以/开头，由 location 的 root 解析）
用 PHP 脚本做统一错误处理（支持发邮件、跳转）
phpEnv 的 Nginx 默认不开启 fastcgi_intercept_errors，所以后端 PHP 报 500 或代理后端挂掉返回 502 时，Nginx 不会触发 error_page。必须手动加这一行：
- 在站点的 Nginx 配置片段（即上面提到的
site_80.conf）的location ~ \.php$块内，加入fastcgi_intercept_errors on; -
error_page 500 502 /error.php;—— 注意这里不能带 query 参数（如?code=502），phpEnv 的 fastcgi_param 传递机制对 URI 参数支持不稳定 -
location = /error.php块中，fastcgi_pass必须写成127.0.0.1:9000（phpEnv 固定端口），不能用 socket 路径 -
error.php文件要放在C:/phpEnv/www/下，开头加header("HTTP/1.1 500 Internal Server Error");避免被缓存，再执行 mail() 或 header("Location: ...")
验证时别用浏览器直接输 /404.html
因为 internal 会拦截直接访问，输 http://localhost/404.html 一定返回 404。正确验证方式只有两个：
- 访问一个真实不存在的路径，比如
http://localhost/_test_abc123 - 在 PHP 脚本里临时加
trigger_error("test", E_USER_ERROR);或exit("500");，看是否跳转到/error.php
最容易被忽略的是：phpEnv 的 Nginx 进程常驻后台，改完配置必须点「环境管理器」里的「重载 Nginx」按钮，而不是只运行 nginx -s reload —— 后者可能找不到 phpEnv 注入的环境变量，导致 fastcgi_pass 失败。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
