Composer scripts 不执行 shell 命令,而是直接调用可执行程序;需显式使用 sh -c 或 cmd /c 才能可靠运行 shell 片段,否则如 "echo hello && ls" 会被当作单一命令名导致报错。

Composer 的 scripts 本身不执行 shell 命令,它只调用 PHP 函数或外部可执行程序——关键在你怎么写命令、怎么转义、怎么控制环境。
scripts 中直接写 shell 命令为什么有时不生效
Composer 默认把 scripts 里的字符串当「可执行文件名 + 参数」处理,不是丢给 /bin/sh 解析。比如 "echo hello && ls" 会被当成一个叫 echo hello && ls 的命令去执行,自然报错 Command "echo hello && ls" is not defined。
- 只有单条、无管道/重定向/逻辑运算符的命令才可能“碰巧”成功(如
php -v) - Windows 下默认走
cmd.exe,Linux/macOS 走sh -c,但 Composer 不保证统一行为 - 路径、环境变量(如
$PATH)、当前工作目录都依赖宿主 shell,不可控
正确写法:显式调用 sh -c 或 cmd /c
想可靠运行 shell 片段,必须手动指定解释器。这是最直接、兼容性最好的方式。
- Linux/macOS:用
sh -c "your command",注意双引号内变量需转义(如\$PWD) - Windows:用
cmd /c "your command",避免路径空格引发问题 - 跨平台项目建议拆成两个 script,或用第三方包如
consolidation/robo封装逻辑
示例(composer.json):
"scripts": {
"build": [
"@composer install",
"sh -c \"find ./src -name '*.php' | xargs php-cs-fixer fix --dry-run\""
]
}
scripts 中调用自定义 PHP 脚本比写 shell 更稳
如果你的逻辑涉及判断、循环、错误处理,硬塞 shell 很容易失控。PHP 脚本可读性强、调试方便、环境可控。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 脚本入口必须是可执行的(
#!/usr/bin/env php+chmod +x),或通过php your-script.php调用 - Composer 自动把
vendor/bin加入 PATH,所以phpunit、php-cs-fixer这类工具可直接写名字 - 别在脚本里用
die()或未捕获异常,否则 Composer 会静默失败;用exit(1)显式返回错误码
比如想检查某个文件是否存在再执行构建:
"scripts": {
"pre-build": "php build-check.php",
"build": "@composer install"
}
常见陷阱:PATH、工作目录、输出缓冲
Composer 执行 scripts 时,环境和你手动敲命令并不总是一致。
-
PATH可能不含vendor/bin,导致phpunit找不到——优先用./vendor/bin/phpunit绝对路径 - 当前工作目录是 composer.json 所在目录,不是你想象的项目根或子目录
- 输出默认被缓冲,长任务看不到实时日志;加
-v参数(composer run build -v)可强制刷新 - 交互式命令(如
read、git commit)在 CI 环境会卡住,务必加--no-interaction或提前设好环境变量
真正麻烦的从来不是“能不能跑”,而是“在谁的环境下、以什么权限、带什么上下文跑”。这些细节漏掉一个,本地 OK、CI 报错就是常态。










