核心问题是环境变量未注入php进程；需按部署方式选择nginx fastcgi_param、php-fpm env[]配置或docker -e参数透传，并验证variables_order含e以启用$_env。
PHP接口配置环境变量读取不到，核心问题通常不是代码写错，而是环境变量根本没进到 PHP 进程里。尤其在 Web 场景（如 Nginx + php-fpm）下，系统级 export 或 .env 文件不会自动生效，必须走明确的注入路径。
明确变量是否真正进入 PHP 进程
先验证基础事实：
- 在接口脚本开头加一行调试代码：
var_dump(getenv('APP_ENV'), $_SERVER['APP_ENV'] ?? null, $_ENV['APP_ENV'] ?? null); exit; - 如果三个都为空，说明变量没传进来；如果
$_SERVER['APP_ENV']有值但getenv()没值，说明是透传方式问题（比如用了fastcgi_param）；如果getenv()有值但$_ENV没值，大概率是variables_order缺少E。
看部署方式，选对应注入路径
-
Nginx + php-fpm（最常见）
- 在
location ~ \.php$块中，include fastcgi.conf;之后添加：fastcgi_param APP_ENV production; fastcgi_param DB_HOST 127.0.0.1;
- PHP 中统一用
$_SERVER['APP_ENV']读取（最稳定），不依赖getenv()或$_ENV。
- 在
-
php-fpm 配置注入（推荐用于全局变量）
- 编辑
www.conf（路径如/etc/php/8.3/fpm/pool.d/www.conf），在[www]段内添加：env[APP_ENV] = production env[DB_HOST] = 127.0.0.1
- 重启 php-fpm：
systemctl reload php8.3-fpm（或对应版本） - 此时
getenv('APP_ENV')和$_ENV['APP_ENV']都可用（前提是variables_order含E）。
- 编辑
-
Docker 容器内
- 确保
docker run -e APP_ENV=prod或environment:在docker-compose.yml中正确声明； - 同时检查
.env文件是否挂载到容器内正确路径（通常是项目根目录），且DotEnv::load()在入口文件最顶部调用； - 不要依赖
export命令——容器启动后 shell 环境已失效。
- 确保
检查 PHP 自身配置是否允许读取
- 打开
php.ini，确认这一行存在且启用：variables_order = "EGPCS"
（
E表示 Environment，缺了它$_ENV就永远为空） - 修改后需重启 PHP 进程（如
systemctl restart php8.3-fpm）。
ThinkPHP/Laravel 等框架的特别注意点
- ThinkPHP 默认不自动加载
.env，必须手动调用Dotenv::createImmutable(__DIR__.'/..')->safeLoad()； - Laravel 的
env()函数只在bootstrap/app.php初始化前有效，配置文件里直接写env('DB_HOST')是安全的，但不能在控制器里反复调用指望它动态刷新； - Swoole/Workerman 等常驻进程需在启动时一次性加载
.env，运行中改.env不生效。
安全提醒
-
clear_env = no（php-fpm）或env[]注入虽能解决问题，但会把所有父进程变量（如HOSTNAME、KUBERNETES_SERVICE_HOST）透传进来，生产环境慎用； - 敏感变量（如密码、密钥）建议通过
fastcgi_param或systemd Environment=注入，避免写进.env提交到代码库； - 不要用
putenv()在接口里动态设变量——它只对当前请求有效，且无法被$_ENV自动捕获。
不复杂但容易忽略
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
