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免费学习笔记（深入）”；
为什么不要用 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点清空”）解耦，改用版本号或事件驱动失效。
