composer 如何处理 post-root-package-install 事件？-composer-PHP中文网

composer 如何处理 post-root-package-install 事件？

尼克

发布： 2025-12-20 08:31:15

原创

804人浏览过

post-root-package-install 事件在项目根包安装后触发，用于执行初始化操作；2. 可通过 composer.json 的 scripts 字段配置内联命令、静态方法或外部脚本；3. 常用于生成配置文件、提示用户操作等场景，仅执行一次，适用于项目创建或首次安装。

composer 如何处理 post-root-package-install 事件？

当 Composer 安装项目根包（即你项目中的 composer.json 对应的包）完成后，会触发 post-root-package-install 事件。这个事件通常在新建项目、运行 composer install 或 create-project 时被调用。

你可以通过在 composer.json 中定义脚本来处理该事件，实现一些初始化操作，比如生成配置文件、提示用户下一步操作等。

如何配置 post-root-package-install 脚本

在项目的 composer.json 文件中，使用 scripts 字段添加对 post-root-package-install 的监听：

{
    "name": "your-vendor/your-project",
    "type": "project",
    "require": {},
    "scripts": {
        "post-root-package-install": [
            "@php -r "echo '欢迎使用本项目！\n';"",
            "SomeScript::welcome"
        ]
    }
}

登录后复制

支持的脚本类型包括：