composer中的scripts如何传递参数

答案：Composer脚本不直接支持命令行传参，推荐使用环境变量传递参数。通过MY_ARG=value composer run my-script设置环境变量，在PHP脚本中用getenv()读取；或结合shell脚本封装并导出变量，再在脚本中接收$event->getArguments()获取有限上下文信息，但最稳定方式仍是环境变量。

在 Composer 中，scripts 是定义在 composer.json 中的自定义命令钩子，比如在安装、更新或 dump 自动加载时触发。但这些脚本本身不直接支持通过命令行传参，需要一些技巧来实现参数传递。

1. 使用环境变量传参

最常用的方式是通过设置环境变量，在脚本执行时读取这些变量。

例如，在命令行中运行：

上面这样写并不会自动把参数传进 PHP 脚本，你需要换一种方式：

改用环境变量：

然后在你的 PHP 脚本中获取：

$arg = getenv('MY_ARG') ?: 'default';
echo "Received: $arg";

对应的 composer.json 配置：

"scripts": {
    "my-script": "MyNamespace\Script::run"
}

2. 通过 Composer 参数传入（有限支持）

Composer 的 run-script 命令允许附加参数，但这些参数会作为全局选项处理，并不会自动传给脚本方法。

你可以这样尝试：

Symanto Text Insights

基于心理语言学分析的数据分析和用户洞察

84

查看详情

但注意：这些参数是传给 Composer 自身的，不是直接传给脚本函数的。除非你在脚本中解析 $_SERVER['argv']，否则无法获取。

如果你一定要从 argv 解析，可以在脚本中这么做：

// 注意：这种方式只在以 bin 形式调用或特殊配置下有效
global $argv;
foreach ($argv as $arg) {
    if (strpos($arg, '--key=') === 0) {
        $value = substr($arg, 6);
    }
}

但这通常不可靠，因为 Composer 并不保证将参数透传到静态方法中。

3. 推荐做法：使用环境变量 + 包装脚本

更清晰的方式是写一个小型包装脚本，通过 shell 设置变量再调用 Composer：

PHP 脚本中读取：

class Script {
    public static function customCommand($event) {
        $mode = getenv('SCRIPT_MODE') ?: 'prod';
        $debug = getenv('DEBUG') === 'true';
<pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">    echo "Running in $mode mode, debug: " . ($debug ? 'on' : 'off');
}

}

4. 利用事件对象获取信息

虽然不能直接传参数，但脚本可以接收 ComposerScriptEvent 对象，从中获取一些上下文：

public static function myScript($event) {
    $args = $event->getArguments(); // 获取命令行参数（如果有的话）
    $io = $event->getIO();
}

但注意：getArguments() 只有在通过某些特定命令（如 create-project）触发脚本时才有值，普通 run-script 不会填充它。

基本上就这些。Composer 脚本本身设计上不是为了接收复杂参数，所以最稳定的方式还是用环境变量控制行为。不复杂但容易忽略。

以上就是composer中的scripts如何传递参数的详细内容，更多请关注php中文网其它相关文章！