post-install-cmd在install或update时触发,用于安装后操作如生成配置;post-update-cmd仅在update时触发,适用于更新后处理如清理缓存。

在 Composer 中,post-update-cmd 和 post-install-cmd 都是脚本事件(script events),用于在特定操作完成后自动执行自定义命令。它们的区别主要在于触发的时机不同。
post-install-cmd 的触发时机
这个事件在以下情况被触发:
- 执行
composer install - 执行
composer update(也会触发)
但关键点是:它只在 依赖被安装或重新安装 时运行。例如:
- 第一次运行
composer install,会触发。 - 如果
composer.lock存在且没有变化,再次运行install,可能不会真正安装包,此时不一定触发(取决于是否实际执行了安装动作)。
post-update-cmd 的触发时机
这个事件仅在执行 composer update 命令时触发,不管是否真的有包被更新。
- 运行
composer update→ 触发 post-update-cmd。 - 运行
composer install→ 不触发 post-update-cmd。
它专门用于处理“更新”场景下的后续操作,比如清除缓存、重新生成配置等需要在依赖变更后执行的任务。
常见使用场景对比
post-install-cmd 更适合:- 项目初始化设置,如创建目录、生成.env文件。
- 确保每次安装依赖后都运行的命令,比如构建类映射(如 Laravel 的优化)。
- 当明确需要在更新包之后执行的操作,比如提醒开发者检查变更日志。
- 清理旧版本残留文件,或重新发布公开资源(如 Laravel 中的 vendor:publish)。
配置示例
在 composer.json 中可以这样写:
"scripts": {
"post-install-cmd": [
"echo '依赖已安装或重新安装'"
],
"post-update-cmd": [
"echo '依赖已更新,请检查是否有 breaking changes'"
]
}
基本上就这些。简单记:install 是装包,update 是升级包;两个事件分别对应这两个动作的“事后处理”。虽然 update 会同时触发两者,但 install 只触发 post-install-cmd。根据你要响应的操作选择合适的钩子就行。不复杂但容易忽略细节。










