filemtime() 是获取文件最后修改时间戳最可靠方式,返回秒级 Unix 时间戳;需判断 false 值并避免用 stat() 或 getlastmod() 替代,时间比较前须统一转为时间戳,注意时区一致性与缓存问题。

用 filemtime() 获取文件最后修改时间
PHP 判断文件是否在某个时间区间内被修改,核心是先拿到准确的修改时间戳。直接调用 filemtime() 是最可靠方式,它返回的是 Unix 时间戳(秒级),不是字符串或格式化日期。
注意:该函数要求文件存在且可读,否则会触发警告并返回 false。务必加判断:
if (false === $mtime = @filemtime($filepath)) {
// 文件不存在、无权限或路径错误
}别用 stat() 或 getlastmod() 替代——前者开销大且字段易混淆,后者只返回当前脚本的修改时间,完全不适用。
把时间区间转成时间戳再比较
PHP 不支持直接拿字符串日期(如 "2024-05-01")和 filemtime() 返回值做大小比较。必须统一转为整型时间戳。
立即学习“PHP免费学习笔记(深入)”;
常见错误写法:$mtime > '2024-05-01' —— 这是在比字符串,结果不可靠。
正确做法:
- 用
strtotime()转区间边界(支持相对时间,如"-7 days") - 用
DateTime类更严谨(尤其涉及时区或复杂格式时) - 确保所有时间戳基于同一时区,否则跨时区服务器可能出错
示例:判断文件是否在过去 24 小时内修改过
$mtime = filemtime($filepath);
$oneDayAgo = strtotime('-24 hours');
if ($mtime > $oneDayAgo) { /* 是 */ }处理时区与夏令时带来的偏移
strtotime() 默认使用 PHP 配置的时区(date_default_timezone_get()),但 filemtime() 返回的是系统本地时间戳(即 UTC + 系统时区偏移),二者逻辑一致——只要没手动改过时区,通常没问题。
真正容易出问题的是:你在代码里用 date('Y-m-d H:i:s', $mtime) 显示时间,又拿这个格式去比对,中间多了一次时区转换,极易偏差一小时。
建议全程用时间戳运算,仅在最终输出时格式化。如果业务强依赖本地时区(比如“今天 8:00 之后”),则统一用 DateTime 并显式指定时区:
$tz = new DateTimeZone('Asia/Shanghai');
$dt = new DateTime('today 08:00', $tz);
$start = $dt->getTimestamp();注意 filemtime() 的缓存与精度问题
PHP 会缓存文件状态(包括修改时间),连续多次调用 filemtime() 可能返回相同结果,即使文件已被外部程序修改。需要强制刷新缓存时,调用 clearstatcache(true, $filepath)。
另外,NTFS 和 ext4 文件系统的时间戳精度不同:NTFS 默认只精确到 100 纳秒(但 PHP 只取秒),ext4 默认是秒级;而某些网络文件系统(如 NFS)可能有几秒延迟。不要依赖毫秒级判断。
如果要检测“是否刚被写入”,除了时间戳,还可结合 filesize() 是否变化、或用 inotify 扩展监听事件——单纯靠时间区间在高并发写入场景下不够鲁棒。











