可通过环境变量、命令行参数、事件对象或预设别名实现composer脚本传参。1. 环境变量最灵活,运行时设值并在php中getenv读取;2. 外部命令可用–传递参数,通过$argv获取;3. PHP回调可从Event对象的getArguments()读取参数;4. 预设带参别名脚本适用于固定组合。推荐按脚本类型选择环境变量或命令行参数方式。

在 composer.json 的 scripts 中直接传递参数不能像普通命令行那样自由拼接,但可以通过几种方式实现参数化执行。关键是利用 Composer 脚本支持的事件对象和自定义脚本逻辑。
1. 使用环境变量传参
最灵活的方式是通过环境变量向脚本传递参数。你可以在运行 composer run 时设置环境变量,然后在处理脚本的 PHP 方法中读取。
示例:
在 composer.json 中定义脚本:
"scripts": { "my-command": "MyScript::handle" }
调用时传入参数(通过环境变量):
MY_ARG="value" composer run my-command
在 PHP 类中读取:
namespace My; use ComposerScriptEvent; class Script { public static function handle(Event $event) { $value = getenv('MY_ARG'); echo "Received: " . $value; } }
2. 使用脚本参数占位(仅限命令行脚本)
如果脚本是执行外部命令(如 shell 脚本或 PHP CLI 工具),可以在运行 composer run 时附加参数,Composer 会将其传递给脚本命令。
注意:这种方式只适用于直接执行可执行命令,不适用于 PHP 回调方法。
定义脚本:
"scripts": { "run-task": ["php script.php"] }
运行并传参:
composer run run-task -- --name=John --debug
这里的 -- 表示后面的内容是传给脚本的参数,script.php 可以通过 $argv 获取这些参数。
3. 利用 Composer 的事件接口获取参数
当使用 PHP 方法作为脚本处理器时,Event 对象可以访问命令行参数(如果有)。
public static function handle(Event $event) { $args = $event->getArguments(); // 参数以数组形式传递,例如: // composer run my-command arg1 arg2 var_dump($args); // 输出: ['arg1', 'arg2'] }
要启用这种传参方式,脚本必须定义为可执行命令(需要注册脚本命令),或者通过 composer run <script> -- arg1 arg2 显式传参。
4. 定义多个带参别名脚本
如果常用几种固定参数组合,可以在 scripts 中预设多个别名。
"scripts": { "build:dev": "php build.php --env=development", "build:prod": "php build.php --env=production" }
使用:
composer run build:dev
基本上就这些实用方式。最推荐的是结合环境变量和命令行参数,根据脚本类型选择合适的方法。Composer 本身不支持像函数调用那样直接传参,但通过这些技巧可以实现灵活控制。


