在composer.json中定义pre-install-cmd事件并绑定检查脚本；2. 编写PHP脚本验证PHP版本、扩展和目录权限，确保环境符合要求后再执行安装。
让 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 文件，内容示例如下：
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
}
3. 确保脚本可执行（可选）
在 Linux/macOS 上，可以为脚本添加可执行权限：
chmod +x scripts/check-env.php
如果使用的是更复杂的命令，也可以写成 shell 脚本并调用。
4. 测试效果
运行以下命令测试：
composer install如果环境不符合要求，脚本会输出错误并退出，Composer 将终止安装流程。
基本上就这些。只要脚本返回非零退出码，Composer 就会中断后续操作，确保部署或开发环境满足前提条件。
