post-package-update 是 Composer 的事件钩子,用于在包更新后自动执行脚本。可在 composer.json 的 scripts 中配置,如运行缓存清理、代码测试等;支持 shell 命令或 PHP 回调函数,需确保类文件被自动加载;该事件仅在 update 后触发,不适用于安装,且脚本失败会中断命令执行。
在 Composer 中,
post-package-update
是一个事件钩子,可以在所有包更新完成后自动执行自定义脚本。这个功能常用于清理缓存、重新生成配置或运行代码检查等操作。
1. 配置 post-package-update 脚本
你可以在
composer.json
文件的
scripts
部分添加
post-package-update
事件:
当运行
composer update
命令后,Composer 会自动触发这个事件,并依次执行列出的命令。
2. 使用自定义 PHP 函数或类方法
除了 shell 命令,还可以调用 PHP
回调函数
。先定义一个类:
然后在
composer.json
中引用它:
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载
确保你的自动加载配置包含了该类文件(例如通过
files
或
classmap
)。
3. 注意事项与常见用途
这个事件只在
composer update
执行完毕后触发,不会在安装时运行(安装使用
post-install-cmd
)。
适合运行测试、静态分析、资源编译等维护性任务
避免阻塞太久的操作,以免影响开发效率
脚本失败会导致整个 composer 命令报错退出
如果只想对特定包更新做响应,目前需在脚本中自行判断版本变化。
基本上就这些。合理使用
post-package-update
可以让项目在依赖变更后自动保持良好状态。
{
"scripts": {
"post-package-update": [
"echo '包已更新,正在执行后续操作...'",
"php artisan optimize",
"phpunit"
]
}
}
"scripts": {
"post-package-update": [
"My\ScriptHandler::onPostUpdate"
]
}
