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)导致其版本升级或降级时,该事件被触发——只针对实际发生版本变动的包。
- 适合做迁移类任务,例如运行数据库迁移、清理缓存、检查兼容性提示
- 可对比旧版本与新版本(
$event->getOperation()->getInitialPackage()和getTargetPackage()) - 若包版本未变(即使其他依赖更新),此事件不会触发
两者都不适用于全局项目级操作
它们是“按包触发”的事件,不是每个命令只跑一次。如果一次命令安装/更新了 5 个包,对应事件就会分别触发 5 次(每次传入不同包对象)。若需项目级收尾动作,应使用 post-install-cmd 或 post-update-cmd。
基本上就这些。不复杂但容易忽略触发粒度——关键看是不是“这个包”本身发生了安装或版本变化。










