post-package-update 是 Composer 的事件钩子，用于在包更新后自动执行脚本。可在 composer.json 的 scripts 中配置，如运行缓存清理、代码测试等；支持 shell 命令或 PHP 回调函数，需确保类文件被自动加载；该事件仅在 update 后触发，不适用于安装，且脚本失败会中断命令执行。
在 Composer 中，post-package-update 是一个事件钩子，可以在所有包更新完成后自动执行自定义脚本。这个功能常用于清理缓存、重新生成配置或运行代码检查等操作。
1. 配置 post-package-update 脚本
你可以在 composer.json 文件的 scripts 部分添加 post-package-update 事件：
{
"scripts": {
"post-package-update": [
"echo '包已更新，正在执行后续操作...'",
"php artisan optimize",
"phpunit"
]
}
}
当运行 composer update 命令后，Composer 会自动触发这个事件，并依次执行列出的命令。
2. 使用自定义 PHP 函数或类方法
除了 shell 命令，还可以调用 PHP 回调函数。先定义一个类：
<?php
class ScriptHandler
{
public static function onPostUpdate($event)
{
echo "执行 post-update 清理任务...
";
// 比如清除缓存文件
if (is_dir('cache/')) {
array_map('unlink', glob("cache/*.php"));
}
}
}
然后在 composer.json 中引用它：
"scripts": {
"post-package-update": [
"My\ScriptHandler::onPostUpdate"
]
}
确保你的自动加载配置包含了该类文件（例如通过 files 或 classmap）。
3. 注意事项与常见用途
这个事件只在 composer update 执行完毕后触发，不会在安装时运行（安装使用 post-install-cmd）。
- 适合运行测试、静态分析、资源编译等维护性任务
- 避免阻塞太久的操作，以免影响开发效率
- 脚本失败会导致整个 composer 命令报错退出
如果只想对特定包更新做响应，目前需在脚本中自行判断版本变化。
基本上就这些。合理使用 post-package-update 可以让项目在依赖变更后自动保持良好状态。
