Composer如何配置pre-install-cmd执行前置钩子

在使用 Composer 时，可以通过配置 pre-install-cmd 钩子，在执行 composer install 命令前自动运行一些自定义脚本。这个机制适用于需要在依赖安装前完成某些操作的场景，比如环境检查、生成配置文件或清除缓存。

1. 在 composer.json 中定义 pre-install-cmd

打开项目根目录下的 composer.json 文件，在 scripts 字段中添加 pre-install-cmd：

{
    "scripts": {
        "pre-install-cmd": [
            "echo '即将开始安装依赖...'",
            "php scripts/check-env.php",
            "@php artisan clear-compiled"
        ]
    }
}

说明：

• 可以指定多个命令，按顺序执行。
• 支持 shell 命令（如 echo）和 PHP 脚本（如 php scripts/check-env.php）。
• 使用 @ 前缀可调用已定义的 Composer 命令别名（如 Laravel 的 @php artisan）。

2. 使用自定义 PHP 类处理更复杂逻辑

对于需要更复杂控制逻辑的情况，可以编写一个 PHP 类来处理钩子事件。

Veo

Google 最新发布的 AI 视频生成模型

下载

先在 composer.json 中注册类方法：

{
    "scripts": {
        "pre-install-cmd": [
            "MyScripts\Build::preInstall"
        ]
    }
}

然后创建对应的 PHP 文件，例如 scripts/Build.php：

<?php
namespace MyScripts;

use ComposerScriptEvent;

class Build
{
    public static function preInstall(Event $event)
    {
        $io = $event->getIO();
        $io->write('<info>正在执行前置检查...</info>');

        if (!is_writable('vendor')) {
            $io->writeError('<error>vendor 目录不可写！</error>');
            exit(1);
        }
    }
}

确保 Composer 能加载该类，可通过 autoload 注册命名空间：

"autoload": {
    "psr-4": {
        "MyScripts\": "scripts/"
    }
}

记得运行 composer dump-autoload 更新自动加载映射。

3. 注意事项

• 执行时机：pre-install-cmd 在 install 执行前触发，但不会在 update 时触发。如需更新前执行，应使用 pre-update-cmd。
• 退出码：如果脚本返回非零状态码，Composer 将中断安装流程。
• 权限问题：确保脚本有执行权限，尤其是在 Linux/macOS 系统上。
• 跨平台兼容：避免使用特定系统的命令（如 del 或 rm），推荐使用 PHP 脚本提升兼容性。