phpEnv配置Nginx自定义错误码重定向 phpEnv错误处理-php教程-PHP中文网

phpenv 不参与 nginx 错误码重定向，仅负责加载 .env；error.php 中环境变量失效主因是未显式初始化 phpenv 且 php-fpm 子进程默认不读取 .env。

phpenv配置nginx自定义错误码重定向 phpenv错误处理

直接说结论：phpEnv 本身不参与 Nginx 错误码重定向逻辑，它只负责加载 .env 文件供 PHP 脚本读取；Nginx 的 error_page 行为完全独立于 phpEnv，但若你在自定义错误处理脚本（如 /error.php）中依赖环境变量，phpEnv 就必须正确初始化——否则邮件配置、API 密钥等会失效。

为什么 phpEnv 在 error.php 中常失效

常见现象：访问 /error.php 直接报错“undefined index 'MAIL_HOST'”，或发送邮件失败。根本原因不是 Nginx 配置错，而是 PHP 进程启动方式导致环境变量未加载。

Nginx 通过 fastcgi_pass 调用 PHP-FPM，而 PHP-FPM 子进程默认不自动读取项目根目录的 .env
phpEnv（即 vlucas/phpdotenv）需在脚本最开头显式调用 Dotenv::createImmutable() 才生效
如果 error.php 没有 require 'vendor/autoload.php'; + Dotenv::createImmutable(...)->load();，$_ENV 和 getenv() 就是空的
PHP-FPM 的 variables_order 若不含 E（比如设成 "GPCS"），$_ENV 会被禁用，仅靠 phpEnv 也救不回来

error_page 指向 PHP 脚本时的 Nginx 配置要点

关键不是“能不能跳”，而是“跳过去后脚本能拿到什么”。以下配置片段必须同时满足：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

error_page 404 /error.php?code=404; —— 必须带查询参数，方便脚本区分错误类型
location = /error.php { internal; ... } —— internal 防止用户直接访问，避免暴露调试信息
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; —— 确保 PHP 知道当前执行的是哪个文件，否则 __DIR__ 可能错位
不要漏掉 fastcgi_intercept_errors on;（尤其在反向代理场景），否则后端返回的 404/500 会被透传，Nginx 根本不会触发 error_page

error.php 中安全使用 phpEnv 的写法

不能假设 vendor/autoload.php 已加载，也不能假设 .env 在 Web 根目录。示例代码核心段：

<?php // 显式指定 .env 路径，避免依赖当前工作目录
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
try {
    $dotenv->load();
} catch (Dotenv\Exception\InvalidPathException $e) {
    // .env 不存在？至少 fallback 到硬编码值或直接 exit
    http_response_code(500);
    die('Error handler config missing');
}

// 此时 getenv('MAIL_HOST') 或 $_ENV['MAIL_HOST'] 才真正可用
$code = $_GET['code'] ?? 500;
if ($code == 404) {
    header('Location: https://example.com/not-found', true, 302);
    exit;
}
// 其他逻辑：发邮件、记录日志、渲染页面...

注意：header('Location: ...') 必须在任何输出前调用，且 exit 不可省略——否则 Nginx 可能因缓冲区未刷出而卡住连接。

最容易被忽略的一点：PHP-FPM 的 clear_env = no（默认是 yes）决定了系统级环境变量是否透传给子进程；如果你用 putenv() 动态设置过变量，这个开关会影响 phpEnv 的行为。别只盯着 .env 文件，底层运行时环境才是真正的水下冰山。