Composer 脚本参数需用 -- 显式分隔,如 composer run-script my-cmd -- --env=prod;脚本内应使用 getopt() 等标准方式解析 $argv,避免硬索引。

Composer 自定义脚本怎么接收命令行参数
Composer 的 scripts 本身不解析参数,直接在 composer.json 里写 "foo": "php foo.php --bar" 这类命令,后面的 --bar 会被原样传给 PHP 脚本;但如果你用的是 php -r 或 shell 命令,参数容易被 Composer 截断或忽略。
- 真正起作用的是「Shell 层面的参数透传」:Composer 只负责执行命令字符串,不干涉其后续参数
- 必须用
php script.php这种显式调用方式,不能依赖exec或未加引号的变量展开 - Windows 下 CMD 对
%1 %2支持弱,建议统一用 PowerShell 或 WSL 测试
如何让 composer run-script 正确转发参数
composer run-script 默认会把额外参数当作自己的选项处理(比如 -v、--no-ansi),除非你显式用 -- 分隔。这是最常踩的坑——没加 --,参数就消失了。
- 正确写法:
composer run-script my-cmd -- --env=prod --force - 错误写法:
composer run-script my-cmd --env=prod(这个--env被 Composer 自己吃了) - 脚本内部仍需自己解析
$argv或用symfony/console等库,Composer 不做任何解析
PHP 脚本里怎么安全读取这些参数
别直接用 $argv[1] 这种硬索引——位置可能漂移,尤其当脚本被其他工具封装调用时。优先用标准方式解析。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 用
getopt()最轻量:getopt("e:f", ["env:", "force"]) - 避免
$_SERVER['argv']直接暴露,它可能包含 Composer 的启动路径(如/usr/bin/composer) - 如果脚本是通过
php -r内联执行的,$argv会多出一个元素(-r),顺序更不可靠
为什么有时候参数像“消失”了一样
常见现象是:你在终端敲了 composer run-script deploy -- --host=api.example.com,但脚本里打印 $argv 却只有两个元素。大概率是 shell 层面的引号或转义问题,不是 Composer 的锅。
- 检查是否用了单引号包裹整个命令,导致
$或*没展开(但参数一般不受影响) - 确认没有在
composer.json的 script 字段里用$(...)或反引号执行子命令——它们会提前截断参数 - Mac/Linux 下注意 zsh 对空格和等号的处理,
--env=prod比--env prod更稳定
参数透传看着简单,实际卡点都在 shell 层和脚本入口的衔接上。最容易被忽略的是 -- 分隔符的必要性,以及脚本中对 $argv 的健壮性处理——毕竟 Composer 从不保证传进来的数组长度或内容格式。

















