PHP本地环境设置自定义变量教程

PHP CLI 读取自定义环境变量需在进程启动前注入：Linux/macOS用export，Windows CMD用set，PowerShell用$env；Apache需SetEnv透传，PHP-FPM应在pool配置中设env[]；putenv()仅限当前请求生效。

PHP CLI 运行时怎么读取自定义环境变量

PHP 命令行（php -r 或执行脚本）默认不加载系统级或用户级 shell 环境变量，尤其在 Windows 的 CMD/PowerShell、macOS/Linux 的非登录 shell 下容易失效。必须确保变量在 PHP 进程启动前已注入。

• Linux/macOS：用 export MY_VAR=value && php script.php，或写入 ~/.bashrc 后执行 source ~/.bashrc
• Windows CMD：用 set MY_VAR=value & php script.php（注意是 &，不是 &&；set 不跨命令持久）
• Windows PowerShell：用 $env:MY_VAR="value"; php script.php
• 验证是否生效：

  php -r "var_dump(getenv('MY_VAR'));"

  返回 string(5) "value" 才算成功

Apache + PHP-FPM 场景下如何让 getenv() 读到自定义变量

Apache 默认会过滤掉大部分环境变量，即使你在 /etc/environment 或 systemctl 里设置了，PHP 也拿不到。关键在 Apache 配置层显式透传。

• 在 Apache 虚拟主机或目录配置中加：

  SetEnv MY_VAR "production"

• 若用 PHP-FPM，更推荐在 FPM pool 配置（如 /etc/php/*/fpm/pool.d/www.conf）中写：

  env[MY_VAR] = production

  ，然后重启 php-fpm 服务
• 避免用 PassEnv 直接透传系统变量——它依赖 Apache 启动时的环境，而 systemd 管理的服务常不继承用户环境
• PHP 中必须用 getenv('MY_VAR') 或 $_SERVER['MY_VAR'] 读取；$_ENV 默认为空，除非设置 variables_order = "EGPCS"

为什么 putenv() 设置的变量在请求间不生效

putenv() 只影响当前请求生命周期内的进程环境，不能跨请求、跨线程、跨 FPM worker。它适合临时覆盖，不适合全局配置。

• 不要在 index.php 开头写 putenv('APP_ENV=local') 期望所有后续 include 文件都能读到——它确实能被当前脚本后续代码读到，但下次 HTTP 请求就重置了
• 如果想“伪全局”，可在入口统一调用：

  if (!getenv('APP_ENV')) { putenv('APP_ENV=development'); }

  ，但这只是兜底，不解决根本配置问题
• 更可靠的做法：把配置抽成 .env 文件，用 vonage/phpdotenv 或原生 parse_ini_file() 加载，避免依赖环境变量机制

Windows WAMP/XAMPP 下设置失败的典型原因

WAMP/XAMPP 自带的 Apache 通常以 Windows 服务方式运行，它完全脱离你的 CMD/PowerShell 环境，所以你在终端里 set 的变量对它无效。

• 修改 httpd.conf 是唯一稳妥方式：

  SetEnv DATABASE_URL "mysql://root@localhost/myapp"

• 不要改 php.ini 的 variables_order 却忘了配 SetEnv —— $_ENV 为空不是因为 PHP 配置错，而是 Apache 根本没传
• 重启服务必须用 WAMP/XAMPP 控制面板点“Restart All”，直接关窗口再开不会 reload Apache 配置
• 检查是否生效：

  php -r "print_r($_SERVER['DATABASE_URL'] ?? 'not set');

  在浏览器中访问一个 phpinfo() 页面，搜索 DATABASE_URL 看是否出现在 “Apache Environment” 区块

环境变量不是“设了就能用”，关键看 PHP 进程从哪来、谁启动它、中间有几层代理。漏掉 Apache 或 FPM 这一层透传，getenv() 就永远返回 false。