nginx 无内置 phpenv，php 无法直接读取其 env 指令定义的变量；必须通过 fastcgi_param 显式传递或在 php-fpm pool 中配置 env[key]，且需注意 clear_env=yes 的默认清空行为。
PHP 环境下 Nginx 本身**没有“phpEnv”这个内置概念**，也不存在所谓“Nginx 全局变量”能直接被 PHP 脚本读取。常见误解是以为在 nginx.conf 里写 env MY_VAR=abc;，PHP 就能通过 getenv('MY_VAR') 拿到——这不会生效，除非你额外配置了传递链。
为什么 $ENV 变量在 PHP 中为空或缺失
Nginx 的 env 指令只控制 worker 进程继承哪些系统环境变量，它不自动转发给 PHP；而 PHP（尤其是通过 php-fpm）默认**不从父进程继承环境变量**，即使 Nginx worker 有，PHP 也看不到。
- 验证方式：在 PHP 脚本中执行
var_dump($_ENV, getenv('MY_VAR'));，通常返回空数组或false - 根本原因：php-fpm 使用独立的子进程池，默认清空环境变量表（
clear_env = yes是默认值） - nginx 的
fastcgi_param是唯一可靠、标准的传递通道，必须显式设置
在 fastcgi_param 中安全传递环境变量
你要让 PHP 读到某个值，必须在 Nginx 的 location ~ \.php$ 块里用 fastcgi_param 显式注入，且优先级高于 php-fpm 自身的 pool 配置。
- 推荐写法（放在
location ~ \.php$内）：fastcgi_param APP_ENV $ENV_APP_ENV; fastcgi_param DB_HOST $ENV_DB_HOST;
- 注意：
$ENV_APP_ENV是 Nginx 解析的“环境变量引用语法”，仅在fastcgi_param和部分日志指令中有效，不是通用变量展开 - 该语法要求对应环境变量已由启动环境传入（如 systemd service 文件中定义
Environment=APP_ENV=production），且已在 nginx 主配置中用env APP_ENV;白名单声明 - 不要写成
fastcgi_param APP_ENV "production";——硬编码失去灵活性；也不要写fastcgi_param APP_ENV $APP_ENV;——Nginx 不支持这种自定义变量引用
php-fpm pool 配置中的 env 设置（替代方案）
如果你不想/不能改 Nginx 配置，可在 php-fpm 的 pool 配置（如 /etc/php/*/fpm/pool.d/www.conf）里直接设环境变量：
- 添加如下行：
env[APP_ENV] = production env[DB_HOST] = 127.0.0.1
- 该方式对所有经由此 pool 处理的 PHP 请求生效，无需 Nginx 配合，但无法动态响应不同 vhost 或 location 的差异化需求
- 重启 php-fpm 生效：
sudo systemctl restart php*-fpm（版本号需匹配） - 与 Nginx 的
fastcgi_param冲突时，后者优先级更高
PHP 中读取和验证这些变量的实际行为
PHP 脚本里不是所有函数都能拿到这些值，必须区分来源：
-
getenv('APP_ENV')和$_SERVER['APP_ENV']在绝大多数情况下等价，可直接使用 -
$_ENV['APP_ENV']默认为空——因为 PHP 默认不把环境变量导入$_ENV数组，需在php.ini中设置variables_order = "EGPCS"（含 E）才启用 - 最佳实践：统一用
getenv()或$_SERVER，并做空值 fallback：$env = $_SERVER['APP_ENV'] ?? 'development';
- 调试时加一句
error_log(print_r($_SERVER, true), 3, '/tmp/php-env.log');查看实际收到哪些键
真正容易被忽略的是：Nginx 的 env 指令和 fastcgi_param 是两个独立机制，缺一不可；而 php-fpm 的 clear_env = yes 默认行为，会让所有没显式 env[KEY] 或没通过 fastcgi_param 注入的变量彻底消失——这不是 bug，是设计使然。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
