如何让composer在安装前执行环境检查脚本-composer-PHP中文网

如何让composer在安装前执行环境检查脚本

裘德小鎮的故事

发布： 2025-09-24 16:17:01

原创

723人浏览过

在composer.json中定义pre-install-cmd事件并绑定检查脚本；2. 编写PHP脚本验证PHP版本、扩展和目录权限，确保环境符合要求后再执行安装。

如何让composer在安装前执行环境检查脚本

让 Composer 在安装前执行环境检查脚本，可以通过定义 composer.json 中的事件（event）和对应的处理脚本实现。Composer 提供了丰富的事件系统，其中 pre-install-cmd 是在执行 composer install 命令但尚未安装依赖前触发的，非常适合用来运行环境检查。

1. 定义 pre-install-cmd 事件

在项目的 composer.json 文件中，添加 scripts 部分，并绑定 pre-install-cmd 到你的检查脚本：

{
    "scripts": {
        "pre-install-cmd": [
            "php scripts/check-env.php"
        ]
    }
}

登录后复制

这里假设你有一个位于 scripts/check-env.php 的 PHP 脚本，用于检查 PHP 版本、扩展、目录权限等。

2. 编写环境检查脚本

创建 scripts/check-env.php 文件，内容示例如下：

<?php

class EnvChecker
{
    public function run()
    {
        $this->checkPhpVersion();
        $this->checkExtensions();
        $this->checkDirectories();
        echo "✅ 环境检查通过\n";
    }

    private function checkPhpVersion()
    {
        if (version_compare(PHP_VERSION, '7.4.0', '<')) {
            throw new RuntimeException('PHP 版本至少需要 7.4，当前版本：' . PHP_VERSION);
        }
    }

    private function checkExtensions()
    {
        foreach (['mysqli', 'curl', 'json'] as $ext) {
            if (!extension_loaded($ext)) {
                throw new RuntimeException("缺少必需的 PHP 扩展: $ext");
            }
        }
    }

    private function checkDirectories()
    {
        $dirs = ['storage', 'bootstrap/cache'];
        foreach ($dirs as $dir) {
            if (!is_writable($dir)) {
                throw new RuntimeException("目录不可写: $dir");
            }
        }
    }
}

try {
    (new EnvChecker())->run();
} catch (Exception $e) {
    fwrite(STDERR, "环境检查失败: " . $e->getMessage() . "\n");
    exit(1); // 退出码非 0 将中断 composer install
}

登录后复制