Composer脚本中直接用$FOO失效,因JSON双引号内不支持shell变量插值,仅识别${var}格式的预定义或--define注入变量;推荐用--define传参或PHP脚本内读取$_SERVER/getenv()。

Composer脚本里直接用 $FOO 会失效,为什么?
因为 Composer 的 scripts 字段在 JSON 中定义,双引号内不支持 shell 变量插值;即使写成 "php script.php $APP_ENV",JSON 解析器也会把 $APP_ENV 当作普通字符串,根本不会交给 shell 展开。
真正起作用的是 Composer 自己的变量替换机制,它只识别 ${var}(带花括号)且仅限于预定义变量或通过 --define 注入的变量,不自动读取系统环境变量。
- 默认可用变量只有:
${COMPOSER_HOME}、${COMPOSER_BIN_DIR}、${AUTOPACKAGE}等少数几个 -
$_ENV['APP_ENV']在 PHP 脚本里能读到,但不能在scripts命令行字符串中直接引用 - Linux/macOS 的
$APP_ENV或 Windows 的%APP_ENV%在composer.json里纯属无效字符
用 --define 手动注入环境变量最可靠
这是 Composer 原生支持的方式,绕过 shell 解析阶段,由 Composer 主动替换 ${VAR_NAME} 占位符。适合 CI/CD 中动态传参,比如部署时指定环境。
先在 composer.json 里写带占位符的脚本:
"scripts": {
"deploy": "php deploy.php --env=${DEPLOY_ENV}"
}
然后运行时显式注入:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
composer deploy --define DEPLOY_ENV=production
- 必须用
--define KEY=VALUE格式,等号不能有空格 -
${DEPLOY_ENV}在命令执行前就被 Composer 替换,不是 shell 行为,所以跨平台一致 - 多个变量可叠加:
--define APP_ENV=dev --define DEBUG=true - 注意:如果脚本是调用外部命令(如
npm run build),${...}不会透传给 npm,它只对 Composer 解析的那条命令生效
PHP 脚本内部读取环境变量更灵活
当逻辑复杂、需要条件分支或 fallback 时,别硬塞参数进命令行,直接在 PHP 脚本里读 $_SERVER 或 getenv() —— 这才是最可控的做法。
例如 scripts/ci-check.php:
<?php
$env = $_SERVER['CI_ENV'] ?? getenv('CI_ENV') ?: 'local';
if ($env === 'production') {
exec('php artisan migrate --force');
}
对应 composer.json 简单写:
"scripts": {
"ci-check": "php scripts/ci-check.php"
}
- 运行时设置环境变量即可:
CI_ENV=staging composer ci-check - Windows 用户用
set CI_ENV=staging && composer ci-check(cmd)或$env:CI_ENV='staging'; composer ci-check(PowerShell) -
$_SERVER比getenv()更可靠,尤其在某些 SAPI(如 Apache mod_php)下getenv()可能被禁用
避免用 exec("export VAR=...") 在脚本里设环境变量
在 PHP 中调用 exec("export FOO=bar") 是徒劳的 —— 子 shell 设置的变量只在那一行命令生命周期内有效,无法影响后续命令或父进程。
- 错误示范:
exec("export APP_ENV=prod && php app.php")→app.php仍然读不到APP_ENV - 正确做法是用
putenv("APP_ENV=prod")提前设置,或用数组传参:exec("APP_ENV=prod php app.php")(仅限 Unix-like) - 跨平台兼容性差:Windows 不支持
KEY=VAL cmd这种前置赋值语法,得改用set KEY=VAL && cmd,维护成本高
真正麻烦的地方不在怎么传,而在“谁负责清理”——比如 --define 注入的变量会污染后续所有脚本调用,除非显式重置;而 putenv() 设置的变量会在脚本结束时自动释放,但若脚本 fork 多进程,就得自己管理作用域。

















