Composer 的 pre-package-install 事件可以用来做什么？

该事件仅在Composer从源安装包时触发，发生在克隆、检出或解压前，用于动态修改源信息、预检依赖兼容性及动态生成源码内容。

这个事件在 Composer 安装或更新包之前触发，但仅限于从源（source）安装时，也就是当包被克隆、检出或解压前执行。它不适用于从 dist（压缩包）安装的场景，这点很关键。

控制源码获取行为

比如你想统一修改某个包的 Git 仓库地址、切换分支、或跳过某些子模块拉取，可以在该事件里动态调整 $event->getOperation()->getPackage() 返回的包对象的 source 信息（如 url、reference、type）。

• 重写私有镜像 URL：把 packagist.org 的源替换成公司内网 Git 地址
• 强制固定 commit：把 dev-master 替换成具体 hash，避免意外更新
• 禁用子模块：设置 "no-dev": true 或手动清除 source['options']['submodules']

预检依赖兼容性

在真正拉代码前检查当前环境是否满足该包的构建前提，比如 PHP 扩展、系统命令或最低 Git 版本。

标签： php js git json composer app 环境变量 解压