PHP文件缓存通过比较当前时间与缓存文件修改时间(filemtime)的差值判断是否过期,若差值超设定阈值则刷新缓存,因原生无TTL参数支持。
PHP文件缓存如何通过修改文件时间戳控制过期
PHP原生不提供“文件缓存自动过期”机制,
和
本身无 TTL 参数。实际中靠手动检查文件最后修改时间(
)与当前时间对比,决定是否读取或刷新缓存。
关键逻辑是:缓存文件存在 +
缓存路径必须可写,且注意 Web 进程用户(如 www-data、nginx)有权限读写该文件
避免直接用
更新时间戳来“续命”,这会掩盖真实数据陈旧问题
若缓存内容含动态变量(如用户 ID),文件名里必须包含这些标识,否则多个用户共用同一缓存文件会出错
用 serialize/unserialize + 文件时间戳实现带过期的缓存封装
下面是一个轻量封装示例,不依赖外部扩展,适合中小项目:
注意:
执行缓存文件有一定安全风险(仅限可信内容),生产环境建议改用
配合
存储。
立即学习
“
PHP免费学习笔记(深入)
”;
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载
为什么不要用 apcu_cache_exists + file_get_contents 混搭
有人试图用 APCu 缓存“文件是否存在+是否过期”的元信息,再读物理文件——这反而增加复杂度和不一致性风险。
APCu 是进程级内存缓存,不同 FPM worker 进程间不共享元信息,容易误判过期状态
文件系统本身已支持毫秒级
,额外加一层 APCu 元缓存既不提升性能,还引入竞态条件
若真需要高性能,应直接用
/
,而非混合文件+APCu
Windows 下 filemtime 返回时间可能不准的坑
Windows 默认文件系统(NTFS)在某些 PHP 版本(尤其 PHP 7.4 之前)中,
可能返回 2 秒粒度甚至更粗的时间,导致缓存提前/延迟过期。
临时对策:
升级到 PHP 8.0+,该问题已大幅改善
改用
(创建时间)作辅助判断(但仅适用于一次性写入场景)
在缓存写入时,把过期时间戳明确写进文件头(如 JSON 封装
),绕过系统时间精度缺陷
真正难处理的是跨时区部署和 NTP 同步偏差——这时缓存过期逻辑最好和业务时间(如“每天凌晨2点清空”)解耦,改用版本号或事件驱动失效。
file_put_contentsfile_get_contentsfilemtimetime() - filemtime($cache_file) → 可用;否则视为过期,需重建。touch()// 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, '// cache_get('user_123'); // 返回 false 表示过期或不存在
function cache_get($key, $ttl = 300) {
$file = sys_get_tempdir() . '/cache' . md5($key) . '.php';
if (!is_file($file) || (time() - filemtime($file)) > $ttl) {
return false;
}
return include $file;
}includeunserialize(file_get_contents($file))serialize()filemtimeapcu_storeapcu_fetchfilemtimefilectime{"expires": 1717023456, "data": ...}