Nginx 通过 fastcgi_param 显式传递环境变量给 PHP-FPM，需手动映射（如 fastcgi_param APP_ENV $ENV_APP_ENV 或硬编码），而 PHP-FPM pool 的 env[] 配置更稳定且支持系统变量引用（如 env[APP_ENV] = ${APP_ENV}），优先推荐。
在 Linux 运维中，通过 fastcgi_param 向 PHP 脚本传递系统环境变量，本质是让 Nginx 在转发请求给 PHP-FPM 时，把指定的键值对作为 FastCGI 协议中的环境变量字段（PARAMS 帧）发送过去。PHP 脚本内即可用 getenv() 或 $_SERVER 读取——但要注意：Nginx 本身**不自动继承系统级环境变量**，必须显式声明并映射。
在 Nginx 配置中用 fastcgi_param 传递系统变量
Nginx 进程启动时读取的是其主进程环境（如 systemd service 文件中定义的 Environment=），但这些变量默认不会透传给 FastCGI。需手动用 fastcgi_param 拉取并转发：
- 若变量已在 Nginx 主进程环境中存在（例如通过
systemctl edit nginx添加了Environment="APP_ENV=prod"），可在 server 或 location 块中直接引用：
fastcgi_param APP_ENV $ENV_APP_ENV;
⚠️ 注意：$ENV_* 变量需在 Nginx 编译时启用 --with-http_perl_module 或使用较新版本（1.19.1+）才原生支持；否则该变量为空。
立即学习“PHP免费学习笔记（深入）”；
- 更通用、稳定的做法是**硬编码或基于 Nginx 变量构造**：
fastcgi_param APP_ENV "production";
fastcgi_param CONFIG_PATH "/etc/myapp/config/";
- 也可结合 Nginx 内置变量动态生成，例如根据域名区分环境：
fastcgi_param APP_ENV $host; # dev.example.com → "dev.example.com"
fastcgi_param RUNTIME_ZONE $timezone; # 需提前用 map 定义 $timezone
在 PHP-FPM 全局配置中设置环境变量（推荐用于统一配置）
相比 Nginx 层逐 site 设置，PHP-FPM 的 pool 配置支持 env[] 指令，由 PHP-FPM 主进程注入到每个子进程，对所有 PHP 请求生效，且能真正读取系统环境：
- 编辑 PHP-FPM Pool 配置文件（如
/etc/php/8.2/fpm/pool.d/www.conf）：
env[APP_ENV] = "staging"
env[DB_HOST] = "127.0.0.1"
env[TZ] = "Asia/Shanghai"
- 若需读取真实系统环境变量（如 systemd 设置的
Environment="CACHE_DRIVER=redis"），可写成：
env[CACHE_DRIVER] = ${CACHE_DRIVER}
✅ 此方式无需重启 Nginx，只需 systemctl reload php8.2-fpm 即可生效，且变量在 PHP 中可通过 getenv('APP_ENV') 稳定获取。
验证变量是否成功传递到 PHP
部署后务必验证，避免配置“看起来正确却没生效”：
- 在 PHP 脚本中临时加入调试代码：
<?php
var_dump(getenv('APP_ENV')); // 推荐方式，不受 variables_order 限制
var_dump($_SERVER['APP_ENV']); // 也可用，但依赖 PHP 配置
?>
- 检查 Nginx error.log 是否有警告（如
fastcgi_param引用了未定义变量） - 确认 PHP-FPM 日志中无 env 相关报错（
tail -f /var/log/php8.2-fpm.log） - 注意大小写：Linux 环境变量区分大小写，
App_ENV和APP_ENV是两个变量
常见误区与安全提醒
运维中容易忽略的关键点：
-
不要混用两种方式覆盖同一变量：Nginx 的
fastcgi_param APP_ENV和 PHP-FPM 的env[APP_ENV]同时存在时，PHP-FPM 的env[]会覆盖 Nginx 传入的同名变量（PHP-FPM 文档明确说明） - 敏感信息勿明文写死：如数据库密码、API keys，应通过 secret mount（容器）、vault 工具或系统级环境注入，而非直接写在 Nginx 配置文件中
-
修改后必须重载服务：Nginx 修改
fastcgi_param后执行nginx -s reload；PHP-FPM 修改env[]后执行systemctl reload php*-fpm，不是 restart -
路径类变量要确保可访问：如
fastcgi_param CONFIG_DIR "/etc/app/conf"，PHP 脚本需有对应目录读取权限，否则file_get_contents()会失败
