Composer中的post-package-install和post-package-update事件有何不同？（脚本钩子）

post-package-install在新包首次安装后触发，仅针对该包；post-package-update在已有包版本变更后触发，仅针对版本变动的包；二者均按包触发，非项目级。

这两个事件都属于 composer 的脚本钩子（script Events），但触发时机和用途有明确区别：前者在单个包安装完成后触发，后者在单个包更新完成后触发。

post-package-install：新包首次加入项目时执行

当某个包此前未存在于 vendor/ 目录中，且本次通过 composer install 或 composer require 被首次安装成功后，该事件会被触发一次——仅针对这个新装的包。

• 适用于初始化操作，比如生成默认配置文件、发布资源、注册服务提供者（laravel 风格）
• 脚本可通过 $event->getOperation()->getPackage() 获取刚安装的包实例
• 不会在 composer update 中对已存在包重复触发

post-package-update：已有包版本变更后执行

当某个包已在 vendor/ 中存在，而本次 composer update（或带 --with-dependencies 的 require）导致其版本升级或降级时，该事件被触发——只针对实际发生版本变动的包。

MimicPC

一个AI驱动的浏览器运行工具，可以通过浏览器在线安装及运行各种开源的AI应用程序

145

查看详情

• 适合做迁移类任务，例如运行数据库迁移、清理缓存、检查兼容性提示
• 可对比旧版本与新版本（$event->getOperation()->getInitialPackage() 和 getTargetPackage()）
• 若包版本未变（即使其他依赖更新），此事件不会触发

两者都不适用于全局项目级操作

它们是“按包触发”的事件，不是每个命令只跑一次。如果一次命令安装/更新了 5 个包，对应事件就会分别触发 5 次（每次传入不同包对象）。若需项目级收尾动作，应使用 post-install-cmd 或 post-update-cmd。

基本上就这些。不复杂但容易忽略触发粒度——关键看是不是“这个包”本身发生了安装或版本变化。