filemtime()是获取文件最后修改时间戳的唯一可靠方式，返回秒级时间戳且不受时区影响；使用前须用file_exists()和is_readable()校验，避免警告；不可用stat()或getlastmod()替代。
用 filemtime() 获取文件最后修改时间戳
PHP 判断文件修改时间距今多久，第一步必须拿到准确的时间戳。filemtime() 是唯一可靠方式——它返回文件系统记录的最后修改时间（单位：秒），不受时区影响，也不依赖文件内容读取。
注意：filemtime() 对不存在的文件或无权限访问的路径会触发警告并返回 false，务必先检查文件是否存在：
if (file_exists($path) && is_readable($path)) { $ts = filemtime($path); }- 不要用
stat()或getlastmod()替代——前者开销大且字段多易误读，后者只返回当前脚本的修改时间，完全无关 - Windows 下 NTFS 和 Linux 下 ext4 均支持该函数，但 NFS 挂载卷可能因缓存导致时间延迟数秒
计算「距今多少秒/分/小时/天」的健壮写法
拿到时间戳后，直接与 time() 相减得到秒数差，再按需换算。关键在于处理「负值」和「边界情况」——比如文件修改时间晚于当前系统时间（常见于系统时间未同步、手动改过文件时间）：
- 先做校验：
$diff = time() - $ts; if ($diff - 避免用
date_diff()或DateTime类封装——它们引入时区对象、格式化开销，且对“X 天前”这类相对描述反而更难控制精度 - 推荐分段判断逻辑（示例）：
$diff = max(0, time() - $ts); if ($diff < 60) echo $diff . ' 秒前'; elseif ($diff < 3600) echo floor($diff / 60) . ' 分钟前'; elseif ($diff < 86400) echo floor($diff / 3600) . ' 小时前'; else echo floor($diff / 86400) . ' 天前';
注意 filemtime() 的缓存陷阱
PHP 默认启用 stat 缓存，连续调用 filemtime() 可能返回旧值，尤其在文件被外部进程（如 rsync、编辑器保存）快速更新后：
- 强制刷新缓存：
clearstatcache(true, $path);—— 第一个参数为true表示只清指定文件，比clearstatcache()全局清更安全 - 开发阶段可临时关闭缓存：
ini_set('opcache.revalidate_freq', 0);（仅限 CLI 或开发环境，生产禁用） - 如果文件由 PHP 自身写入（如
file_put_contents()），缓存问题通常不出现，因为 PHP 内部会自动更新 stat 缓存
跨时区部署时别碰 date() 格式化原始时间
有人想先用 date('Y-m-d H:i:s', $ts) 转成字符串再计算，这是典型误区——date() 输出受 date_default_timezone_set() 影响，但 filemtime() 返回的是 UTC 时间戳，相减时若混用本地化时间字符串，会导致时区偏移误差（比如显示“25 小时前”却实际只有 1 小时）。
立即学习“PHP免费学习笔记（深入）”；
- 所有计算必须基于时间戳（整数）完成，
date()仅用于最终展示「绝对时间」，例如：date('Y-m-d', $ts) - 若需显示带时区的相对时间（如“2 小时前（CST）”），应统一转为 UTC 时间戳比较，再用
date()加时区标识输出，而不是让date()参与运算
文件修改时间判断看似简单，真正容易出错的是缓存未清、时区混淆、以及对 false 返回值缺乏防御。尤其在容器或 NAS 环境下，filemtime() 的精度和一致性需要实测验证。
