php文件缓存通过比较当前时间与缓存文件修改时间(filemtime)的差值判断是否过期,若差值超设定阈值则刷新缓存,因原生无ttl参数支持。

PHP文件缓存如何通过修改文件时间戳控制过期
PHP原生不提供“文件缓存自动过期”机制,file_put_contents 和 file_get_contents 本身无 TTL 参数。实际中靠手动检查文件最后修改时间(filemtime)与当前时间对比,决定是否读取或刷新缓存。
关键逻辑是:缓存文件存在 + time() - filemtime($cache_file) → 可用;否则视为过期,需重建。
- 缓存路径必须可写,且注意 Web 进程用户(如 www-data、nginx)有权限读写该文件
- 避免直接用
touch()更新时间戳来“续命”,这会掩盖真实数据陈旧问题 - 若缓存内容含动态变量(如用户 ID),文件名里必须包含这些标识,否则多个用户共用同一缓存文件会出错
用 serialize/unserialize + 文件时间戳实现带过期的缓存封装
下面是一个轻量封装示例,不依赖外部扩展,适合中小项目:
// cache_set('user_123', $data, 300); // 缓存5分钟
function cache_set($key, $value, $ttl = 300) {
$file = sys_get_temp_dir() . '/cache_' . md5($key) . '.php';
return file_put_contents($file, '<?php return ' . var_export($value, true) . ';') !== false;
}
<p>// cache_get('user_123'); // 返回 false 表示过期或不存在
function cache_get($key, $ttl = 300) {
$file = sys_get_temp<em>dir() . '/cache</em>' . md5($key) . '.php';
if (!is_file($file) || (time() - filemtime($file)) > $ttl) {
return false;
}
return include $file;
}注意:include 执行缓存文件有一定安全风险(仅限可信内容),生产环境建议改用 unserialize(file_get_contents($file)) 配合 serialize() 存储。
立即学习“PHP免费学习笔记(深入)”;
Vuex是一个专门为Vue.js应用设计的状态管理模型 + 库。它为应用内的所有组件提供集中式存储服务,其中的规则确保状态只能按预期方式变更。它可以与 Vue 官方开发工具扩展(devtools extension) 集成,提供高级特征,比如 零配置时空旅行般(基于时间轴)调试,以及状态快照 导出/导入。本文给大家带来Vuex参考手册,需要的朋友们可以过来看看!
为什么不要用 apcu_cache_exists + file_get_contents 混搭
有人试图用 APCu 缓存“文件是否存在+是否过期”的元信息,再读物理文件——这反而增加复杂度和不一致性风险。
- APCu 是进程级内存缓存,不同 FPM worker 进程间不共享元信息,容易误判过期状态
- 文件系统本身已支持毫秒级
filemtime,额外加一层 APCu 元缓存既不提升性能,还引入竞态条件 - 若真需要高性能,应直接用
apcu_store/apcu_fetch,而非混合文件+APCu
Windows 下 filemtime 返回时间可能不准的坑
Windows 默认文件系统(NTFS)在某些 PHP 版本(尤其 PHP 7.4 之前)中,filemtime 可能返回 2 秒粒度甚至更粗的时间,导致缓存提前/延迟过期。
临时对策:
- 升级到 PHP 8.0+,该问题已大幅改善
- 改用
filectime(创建时间)作辅助判断(但仅适用于一次性写入场景) - 在缓存写入时,把过期时间戳明确写进文件头(如 JSON 封装
{"expires": 1717023456, "data": ...}),绕过系统时间精度缺陷
真正难处理的是跨时区部署和 NTP 同步偏差——这时缓存过期逻辑最好和业务时间(如“每天凌晨2点清空”)解耦,改用版本号或事件驱动失效。










