Composer脚本中$_ENV或getenv()常为空,因其默认以“干净环境”运行并清空变量;正确做法是使用COMPOSER_*前缀变量(如COMPOSER_MY_TOKEN),脚本中读取MY_TOKEN即可,或用cross-env工具透传。

Composer 脚本中直接读取 $_ENV 或 getenv() 为什么经常为空?
因为 Composer 默认以“干净环境”(clean env)运行脚本,会清空或重置大部分系统环境变量,尤其是通过 export VAR=xxx 设置的变量。即使你在 shell 中 echo $MY_VAR 能看到,composer run-script 里也大概率读不到。
正确做法:用 COMPOSER_* 前缀声明变量并传入
Composer 明确支持将形如 COMPOSER_* 的环境变量自动注入到脚本执行环境中。这是唯一被官方文档确认、且跨平台稳定的方式。
- 在终端中设置:
COMPOSER_MY_TOKEN=abc123 composer install - 在脚本中读取:
getenv('MY_TOKEN')(注意:前缀COMPOSER_会被自动剥离) - PHP 脚本内无需额外处理,
$_ENV['MY_TOKEN']和getenv('MY_TOKEN')都可用 - 该机制对
scripts中的php、shell、exec类型都生效
Shell 脚本类 script 怎么安全传递非 COMPOSER_* 变量?
如果必须用非前缀变量(比如对接已有 CI 工具的 CI_JOB_ID),不能依赖 getenv() 直接读 —— 因为它大概率是空的。得靠 shell 层显式透传:
dotenvx 是由 dotenv 的创建者推出的_secure、跨平台环境变量管理器。它提供加密的 .env 文件、多环境支持,并通过其 CLI 运行器与任何编程语言或框架配合使用。
- 在
composer.json中写:"scripts": {"build": "sh -c 'MY_VAR=\"$MY_VAR\" php build.php'"} - 然后在
build.php中用getenv('MY_VAR')—— 此时值已由 shell 注入 - 注意单双引号嵌套和转义:
sh -c 'VAR=\"$CI_JOB_ID\" php script.php'才能正确展开 - Windows cmd 不支持这种语法,需改用 PowerShell 或统一用 cross-env 工具
想彻底避免环境变量陷阱?用 cross-env 最省心
它专为解决跨平台环境变量透传而生,不依赖 Composer 内部机制,也不受 clean env 影响:
- 安装:
composer require --dev cross-env - 定义脚本:
"scripts": {"dev": "cross-env NODE_ENV=development php serve.php"} -
serve.php中可直接用getenv('NODE_ENV'),无需前缀、无平台差异 - 比手动拼
sh -c更可靠,尤其当变量含空格或特殊字符时
真正容易被忽略的是:Composer 的 clean env 是默认行为,不是 bug;很多人花半天调试 getenv() 返回 false,其实只是没意识到这个前提。要么走 COMPOSER_* 路线,要么用 cross-env,硬扛原生环境变量基本没胜算。

















