Laravel File缓存_文件缓存清理策略【指南】-php教程-PHP中文网

File缓存文件存储在storage/framework/cache/data/目录下，为带哈希前缀和.bin后缀的二进制文件，不自动清理过期项，需手动执行cache:clear --driver=file或定期运行cache:prune-stale命令安全清理。

laravel file缓存_文件缓存清理策略【指南】

File缓存不会自动清理过期文件，必须手动触发或依赖系统级策略，否则 storage/framework/cache/data/ 会持续膨胀。

file驱动缓存到底存在哪？

所有通过 Cache::put()、cache()->remember() 等写入的缓存项，在使用 file 驱动时，实际落地为 storage/framework/cache/data/ 目录下的二进制文件（带哈希前缀和 .bin 后缀）。这些文件不按 TTL 删除，也不受 Laravel 请求生命周期管理——PHP 进程退出后仍长期存在。

常见错误现象：cache:clear 执行后 storage/framework/cache/data/ 里文件数量没变；改了缓存过期时间但旧文件还在；磁盘空间缓慢增长却查不到源头。

该目录下文件名无业务含义，无法靠命名识别归属，只能靠 Cache::get() 或 Cache::has() 判断是否有效
cache:clear 命令会调用 FileStore::flush()，它遍历目录并删除所有文件——但仅限于当前配置的 cache.stores.file.path 指向路径
若项目中自定义了多个 file 缓存 store（如 cache.stores.local 指向 storage/cache/local），cache:clear 默认不清理它们，除非显式加 --driver=local

为什么 cache:clear 有时删不干净？

因为 cache:clear 只清「当前默认缓存 store」，而 Laravel 的 cache.default 配置可能不是 file —— 比如你设了 redis 为默认驱动，那 cache:clear 就只执行 FLUSHDB，对 storage/framework/cache/data/ 完全无感。

使用场景：本地开发用 file 驱动调试，但生产环境切到 redis；此时 cache:clear 在本地无效，在线上又误删 redis 全库。

确认当前默认驱动：php artisan tinker → 输入 config('cache.default')
强制清 file 驱动：php artisan cache:clear --driver=file
清多个驱动：php artisan cache:clear --driver=file,redis（Laravel 12+ 支持）
注意：file 驱动的 flush() 不检查文件是否过期，是暴力清空整个目录，慎用于共享缓存目录

如何安全地自动清理过期 file 缓存？

File 驱动本身不提供后台 GC，得靠外部手段。直接 rm -rf storage/framework/cache/data/* 很危险：可能删掉正在被读写的临时文件，导致 Cache::get() 返回 false 或抛出异常。

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

推荐做法是用 Laravel 自带的 prune 机制（Laravel 9.20+）或封装安全脚本：

启用自动修剪：php artisan cache:prune-stale（仅对 file 和 database 驱动生效）
该命令扫描 storage/framework/cache/data/，比对每个文件头里的过期时间戳，只删已过期项
可加入定时任务：$schedule->command('cache:prune-stale')->daily();
若用旧版 Laravel，需手写脚本：用 find storage/framework/cache/data/ -name "*.bin" -mmin +60 -delete（按修改时间删 60 分钟前的）——但注意这和 TTL 不一致，仅作兜底