能安全删除的是系统临时目录(如/tmp、%APPDATA%\Local\Temp)中的composer_.zip、php.phar等残留文件,以及项目自定义构建产物(如public/build/、storage/framework/views/);绝对不能删vendor/composer/autoload_*.php、installed.json、autoload.php及~/.composer/cache下的ZIP包。

哪些临时文件能安全删,哪些碰都别碰
Composer 自身不会在 vendor/ 或项目根目录下生成“可被脚本无脑清理”的临时文件。真正需要关注的两类路径是:sys_get_temp_dir() 返回的系统临时目录(如 /tmp、%APPDATA%\Local\Temp),以及你项目中自定义构建步骤产出的中间产物(如 public/build/、storage/framework/views/)。前者可能堆积大量 composer_*.zip、php*.phar 等残留;后者才是脚本清理的合理目标。
绝对不能删的包括:
-
vendor/composer/autoload_*.php—— Composer 运行时自动加载必需,删了后续命令直接报Class not found -
vendor/composer/installed.json和vendor/autoload.php——composer install的输出成果,不是临时文件 -
~/.composer/cache/下的 ZIP 包 —— 这是跨项目复用的缓存,删了下次 install 会重下,但不算“临时”,且不建议在部署脚本里动它
post-install-cmd 里执行 rm 命令的风险点
直接在 composer.json 的 "post-install-cmd" 里写 rm -rf public/build/* 看似简单,但实际容易出问题:
- Windows 下
rm不可用,必须用del /q或改用 PHP 脚本封装 - 路径含空格或特殊字符时,shell 解析失败(比如
public/build/my app/) - 命令失败不中断后续流程:默认情况下,一条
rm报错(如权限不足)不会让整个composer install失败,但你可能根本没意识到清理没成功 - 没有前置判断:
rm -rf storage/cache/*在storage/cache不存在时会报错,应加[ -d storage/cache ] && rm -rf storage/cache/*
用 PHP 脚本替代 shell 命令更可控
把清理逻辑抽成独立 PHP 文件(如 scripts/clean-temp.php),再通过 Composer 调用,能规避系统差异、路径解析和错误静默问题:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 用
is_dir()和scandir()安全遍历目录,避免 shell 注入风险 - 用
unlink()+rmdir()逐个删除,可加if (file_exists($path)) { ... }判断 - 支持基于时间的清理,比如只删
storage/framework/sessions/中修改超 60 分钟的文件:filemtime($f) - 调用方式统一:
"post-install-cmd": "php scripts/clean-temp.php",无需区分平台
为什么不能在钩子里调用 php artisan cache:clear
因为 composer install 执行时,框架尚未完成初始化——APP_ENV、APP_DEBUG、数据库连接等环境变量通常未加载,php artisan cache:clear 很可能因找不到配置或类而提前退出,甚至报 Class 'App\Providers\AppServiceProvider' not found。这不是命令写错了,而是执行时机错了。
更稳妥的做法是:
- 只用系统命令清理物理文件(如
rm -rf bootstrap/cache/*) - 把框架级命令(
cache:clear、view:clear)放到部署流程的后置环节,比如deploy脚本中,在composer install之后、服务启动之前单独执行 - 若必须在钩子里触发,确保该命令不依赖未就绪的框架上下文,例如只清
storage/logs/这类纯文件目录
最容易被忽略的是临时目录本身的位置和生命周期——sys_get_temp_dir() 返回的路径可能不在你控制的磁盘分区上,清理脚本再完善,也救不了 /tmp 被其他进程塞满的情况。










