如何让Nginx自定义fastcgi_param变量在PHP控制台命令中可见？

在Nginx中通过fastcgi_param定义自定义环境变量后，该变量可在Web浏览器触发的PHP环境中正常读取，但在PHP控制台命令（CLI模式）中无法获取到。

Nginx配置代码 #

fastcgi_param CUSTOM_VARIABLE "custom_variable_value";

Web浏览器触发的PHP环境测试结果 #

var_dump(env('CUSTOM_VARIABLE')); // 返回 "custom_variable_value";
var_dump(getenv('CUSTOM_VARIABLE')); // 返回 "custom_variable_value";
var_dump($_SERVER['CUSTOM_VARIABLE']); // 返回 "custom_variable_value";

PHP控制台命令（CLI模式）测试结果 #

var_dump(env('CUSTOM_VARIABLE')); // 返回错误"Unknown or undefined key"或NULL;
var_dump(getenv('CUSTOM_VARIABLE')); // 返回错误"Unknown or undefined key"或NULL;
var_dump($_SERVER['CUSTOM_VARIABLE']); // 返回错误"Unknown or undefined key"或NULL;

fastcgi_param是Nginx传递给FastCGI进程（如php-fpm）的变量，仅在Web请求上下文生效。PHP CLI模式不经过Nginx和php-fpm，因此无法直接读取这些变量，可通过以下方式解决：

• 系统层面配置环境变量
  在系统全局或用户级配置中添加环境变量：

  • Linux/macOS：编辑~/.bashrc、~/.zshrc或/etc/profile，加入：

    export CUSTOM_VARIABLE="custom_variable_value"
    

    执行source ~/.bashrc（对应使用的shell）使配置立即生效，之后PHP CLI可通过getenv()读取该变量。
  • Windows：在「系统属性-高级-环境变量」中添加对应变量，重启命令提示符后生效。

• 执行CLI命令时临时注入
  每次运行PHP脚本前直接指定变量：

  CUSTOM_VARIABLE="custom_variable_value" php your_script.php
  

• 框架项目统一配置（以Laravel为例）
  在项目的.env文件中添加：

  CUSTOM_VARIABLE=custom_variable_value
  

  同时修改Nginx配置，让fastcgi_param匹配该值：

  fastcgi_param CUSTOM_VARIABLE "custom_variable_value";
  

  这样Web和CLI环境都能通过框架的env()函数读取到统一的变量值。

内容的提问来源于stack exchange，提问作者Volodymyr Oliinyk