Composer 支持 pre-install-cmd 和 pre-update-cmd 钩子，自 1.10+/2.0+ 起稳定可用，会在 install/update 开始前自动执行；需确保未使用 --no-scripts 且版本达标。
Composer 本身不提供 pre-install-cmd 这样的原生脚本钩子，但你可以通过 scripts 配置 + composer install 的 --no-scripts 行为，或借助插件/包装脚本实现“执行 install/update 前运行自定义逻辑”的效果。最实用、无需额外依赖的方式是利用 Composer 的 pre-autoload-dump 或 pre-update-cmd/pre-install-cmd —— 等等，这里需要先澄清一个关键点：
Composer 实际支持的 pre-* 脚本有哪些？
官方文档明确列出的事件钩子中，确实存在 pre-install-cmd 和 pre-update-cmd，它们会在 composer install 和 composer update 命令开始执行（即解析依赖、下载包之前）被触发。
注意：这些钩子从 Composer 1.10+ 和 Composer 2.0+ 开始稳定支持，并在默认启用脚本时自动运行（即未加 --no-scripts）。
如何正确配置 pre-install-cmd / pre-update-cmd
在你的 composer.json 的 scripts 字段中添加对应键即可：
-
pre-install-cmd：在install启动时、任何依赖操作前执行 -
pre-update-cmd：在update启动时、清理锁文件或计算差异前执行
示例配置：
{
"scripts": {
"pre-install-cmd": [
"@php -r \"echo '✅ Running pre-install checks...\\n';\"",
"php scripts/check-env.php"
],
"pre-update-cmd": [
"@php -r \"echo '⚠️ Clearing outdated caches before update...\\n';\"",
"php scripts/clean-cache.php"
]
}
}✅ 运行 composer install 时，会先执行 pre-install-cmd 列表中的所有命令，再继续安装流程。
为什么有时 pre-* 脚本没运行？
常见原因包括：
- 你用了
composer install --no-scripts（显式禁用脚本） - Composer 版本过低（composer self-update
-
"scripts"写在了错误位置（必须是根级字段，不能嵌套在其他字段下） - 脚本中某条命令退出码非 0，导致后续脚本中断（Composer 默认短路执行）
替代方案：更可控的预处理（适合复杂逻辑）
如果需要更强控制（比如根据参数跳过、记录日志、或与 CI 深度集成），可绕过钩子，改用包装脚本：
- 写一个
./bin/install.sh，内容为：#!/bin/bash
php scripts/pre-check.php || exit 1
composer install "$@" - CI 中直接调用该脚本，而非裸跑
composer install - 这样完全自主掌控顺序、错误处理和环境判断
这种方式不依赖 Composer 钩子机制，也避免了钩子执行时机的隐含约束（例如 pre-install-cmd 无法访问已生成的 vendor/autoload.php，因 autoloader 尚未生成）。
基本上就这些。用好 pre-install-cmd 和 pre-update-cmd 是最轻量、最标准的做法，前提是 Composer 版本够新、配置位置正确、没加 --no-scripts。不需要装插件，也不用改全局行为。
