Composer 无原生 post-install/post-update 清理钩子,但可利用 post-autoload-dump 事件间接实现:该事件在每次 autoloader 更新后触发,覆盖 install/update 大多数场景;需在 composer.json 的 scripts 中配置 clean 命令并绑定至 post-autoload-dump。

Composer 本身没有 post-install 或 post-update 后自动清理的原生钩子,但你可以利用 post-autoload-dump 事件间接实现“安装/更新后清理”——因为每次 composer install 或 composer update 成功执行,最终都会触发该事件(只要 autoloader 被重新生成)。
为什么选 post-autoload-dump?
这个事件在 Composer 生成或更新 vendor/autoload.php 后立即触发,覆盖了绝大多数 install/update 场景。它比 post-install-cmd 更可靠:后者仅在首次安装时运行,而 post-autoload-dump 每次 autoloader 变更都执行(包括添加/删包、切换分支、重装 vendor 等)。
在 composer.json 中配置清理脚本
把你的清理逻辑(如删除临时文件、清空缓存目录、生成静态资源等)封装成一个可执行命令,然后注册到 scripts 部分:
示例(删除 var/cache/* 和 public/build/*):
"scripts": {
"clean": "rm -rf var/cache/* public/build/*",
"post-autoload-dump": [
"@clean",
"echo \"✅ Autoloader updated — cleanup done.\""
]
}
Windows 用户请改用 PowerShell 或兼容命令(如 del /q + rmdir /s /q),或统一用 PHP 脚本避免平台差异。
用 PHP 脚本实现跨平台、可维护的清理
创建 scripts/clean.php:
#!/usr/bin/env php
/dev/null");
echo "? Cleared $dir\n";
}
}
然后在 composer.json 中调用:
"scripts": {
"clean": "php scripts/clean.php",
"post-autoload-dump": "@clean"
}
这样既安全又可扩展,还能加日志、条件判断或异常处理。
注意事项与常见问题
-
不保证 100% 触发:如果 composer install 使用
--no-autoloader或--classmap-authoritative且 classmap 未变,可能跳过该事件;但常规开发流程中极少出现。 - 不要放耗时操作:该钩子同步执行,阻塞后续命令;清理应轻量,复杂任务建议用单独命令手动触发。
-
权限与路径注意:脚本以当前用户权限运行,确保对目标目录有写权限;路径建议用相对项目根目录的写法(如
./var/cache),避免硬编码绝对路径。
基本上就这些。用 post-autoload-dump 做清理是社区常用且稳妥的做法,不复杂但容易忽略它的适用边界。










