如何通过PHP的ENV超全局变量高效获取环境变量？

本文共计942个文字，预计阅读时间需要4分钟。

$$\_ENV$$ 默认是空的，不是 PHP，没实现，而是它根自动填充——必须手动配置才能用。

为什么 $_ENV 里什么都没有

PHP 启动时不会自动把操作系统环境变量塞进 $_ENV，它的填充行为完全由 php.ini 中的 variables_order 指令控制。默认值是 GPCS（GET/POST/Cookie/Server），里面没有 E，所以 $_ENV 始终为空数组。

• 检查当前配置：运行 phpinfo()，搜索 variables_order 看是否含 E
• 修改方式：在 php.ini 中设为 variables_order = "EGPCS"
• 改完必须重启 Web 服务（如 nginx + php-fpm）或 CLI 的 PHP 进程，否则无效
• 即使开了 E，$_ENV 也只包含 Web 服务器启动时继承的那批环境变量，不包括运行中动态 set 的

getenv() 是更可靠的选择

getenv() 绕过了 variables_order 限制，直接读取进程级环境变量，无论 PHP 是通过 Web 还是 CLI 启动都有效，且不需要改配置。

• 读取存在变量：getenv('DB_HOST') 返回字符串，或 false（注意不是 null）
• 安全写法：getenv('DB_HOST') ?: '127.0.0.1'，避免 false 被当空字符串误用
• 区分大小写：Linux/macOS 下 getenv('PATH') 有效，getenv('path') 返回 false
• CLI 场景下唯一推荐方式：Web 服务器通常不传递全部系统变量给 $_ENV，但 getenv() 总能读到

PHP-FPM 环境变量注入要配 php-fpm.conf

如果用 PHP-FPM，想让某个变量对所有请求可用（比如 APP_ENV=production），不能只靠系统 export，得在 FPM 配置里显式声明。

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

• 编辑 /etc/php-fpm.d/www.conf 或主 php-fpm.conf
• 添加行：env[APP_ENV] = production（值可带引号，也可用 env[APP_ENV] = $APP_ENV 引用系统变量）
• 重启 php-fpm：仅 reload 不够，得 systemctl restart php-fpm
• 此时 getenv('APP_ENV') 和（如果开了 E）$_ENV['APP_ENV'] 都能拿到值
• 注意：Nginx 的 fastcgi_param 只影响 $_SERVER，不影响 $_ENV 或 getenv()

$_SERVER 和环境变量不是一回事

$_SERVER 是 Web 服务器传给 PHP 的运行时上下文，不是操作系统环境变量。虽然名字像，但来源、生命周期、用途都不同。

• $_SERVER['HOME'] 可能为空，而 getenv('HOME') 通常有值（CLI 下尤其明显）
• $_SERVER['PATH'] 是 CGI/FCGI 协议约定字段，和系统 $PATH 无关
• 敏感信息（如密钥）应避免塞进 $_SERVER，因为可能被 phpinfo() 或错误日志意外暴露
• 真正需要“环境变量语义”的场景（如区分 dev/staging/prod），坚持用 getenv() + 外部注入，别依赖 $_SERVER 模拟

最易忽略的一点：Docker 容器里 getenv() 能读到 ENV 指令设的变量，但 $_ENV 是否可用仍取决于 variables_order；Kubernetes 的 ConfigMap 注入也同理——变量进了进程环境，getenv() 就稳，$_ENV 得额外配。