Composer 不管理临时上传文件,其清理需由应用层实现;推荐用 find 按修改时间筛选删除,或改用跨平台 PHP 脚本精准控制,避免误删活跃文件。

临时上传文件不在 Composer 管理范围内
Composer 本身不生成、不管理「临时上传文件」——它既不会把用户上传的 $_FILES 写到某个固定路径,也不会在 install 或 update 过程中创建这类文件。你看到的 storage/app/uploads/、public/uploads/、/tmp/myapp_*.tmp 等,全是应用层逻辑(比如 Laravel 的 Filesystem、自定义表单处理、或 PHP upload_tmp_dir 配置)产生的,必须由你自己定义清理规则。
用 post-install-cmd 清理需满足三个前提
想让 Composer 脚本自动删上传临时文件,得先确认:你的上传文件确实落盘在项目内可预测路径,且该路径不被框架运行时锁定(比如没被 fopen(..., 'w+') + stream_copy_to_stream() 持有句柄)。否则脚本执行时会报 Permission denied 或 Text file busy。
- 路径必须明确且稳定,例如
storage/tmp/uploads/或public/temp_uploads/;避免依赖sys_get_temp_dir()返回的系统级/tmp,那里混着其他进程的文件,不能随便清 - 清理命令需加存在性判断,防止目录不存在时报错中断:
if [ -d "storage/tmp/uploads" ]; then find storage/tmp/uploads -type f -mmin +30 -delete; fi - 别在
post-install-cmd里调用php artisan storage:link后立刻删public/storage/uploads/—— 符号链接目标可能正被 Web 服务器读取
Linux/macOS 下推荐用 find 加时间阈值清理
直接 rm -rf 全删太粗暴,容易误伤活跃上传(比如大文件分片上传中途被删)。更安全的做法是按修改时间筛选:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
"clear-uploads": "if [ -d 'storage/tmp/uploads' ]; then find storage/tmp/uploads -type f -mmin +60 -delete; fi"
-
-mmin +60表示“60 分钟前修改的文件”,给上传留出足够缓冲窗口 -
-type f只删文件,跳过子目录,防误删结构 - Windows 用户若用 Git Bash,该命令可用;纯 CMD/PowerShell 需改用
forfiles或封装成 PHP 脚本 - 如果上传文件带固定前缀(如
upload_*.part),可加-name "upload_*.part"进一步限定
PHP 脚本比 shell 命令更可控、更跨平台
当清理逻辑变复杂(比如要排除某些 UID 的文件、检查文件哈希、或触发回调通知),硬写 shell 容易失控。建议抽成独立 PHP 脚本,再由 Composer 调用:
"clear-uploads": "php scripts/clean-uploads.php"
- 脚本里用
scandir()+filemtime()+unlink(),可精确控制每一步 - 能捕获
unlink()失败原因(如Permission denied或Operation not permitted),并记录到storage/logs/cleanup.log - 避免 shell 解析空格路径失败的问题(比如路径含中文或括号时,
rm -rf "my dir/"在某些 shell 下仍会崩) - 注意:PHP 脚本需用项目根目录为工作目录运行,不要依赖
__DIR__绝对路径,除非你明确chdir(__DIR__) || die()
真正难的不是“怎么删”,而是“删哪些”和“什么时候删”。上传临时文件生命周期往往依赖业务状态(比如是否已入库、是否关联了任务队列),单纯靠时间戳或后缀匹配,很容易删掉还没处理完的文件。务必先在测试环境跑通逻辑,再上线。










