filemtime() 是 PHP 中获取文件最后修改时间最直接的方式，返回 Unix 时间戳，需用 date() 格式化；使用前应检查文件存在性和可读性，并注意缓存、权限及跨平台差异。
用 filemtime() 获取文件最后修改时间
PHP 中最直接、最常用的方式就是调用 filemtime() 函数。它返回的是 Unix 时间戳（从 1970-01-01 开始的秒数），不是格式化后的字符串，这点容易误以为“没拿到时间”。
常见错误：直接 echo filemtime('test.txt') 看到一串数字就懵了——其实那是正确结果，只是需要转换。
- 必须确保文件存在且 PHP 有读取权限，否则会触发警告并返回
false - 路径要用绝对路径或相对于当前工作目录的路径；用
__DIR__ . '/data/config.php'比硬写'./data/config.php'更可靠 - 若需格式化显示，立刻接
date('Y-m-d H:i:s', $timestamp)，别漏掉第二个参数
filemtime() 和 stat() 的区别在哪
filemtime() 本质是 stat() 的快捷封装，只取 mtime 字段；而 stat() 返回完整数组，包含 atime（访问时间）、ctime（inode 修改时间）等。
性能上几乎无差别，但语义更清晰：只要关心“改了没”，就用 filemtime()；需要对比多个时间点（比如判断是否刚被读过又改过），才值得调 stat() 多取几个字段。
立即学习“PHP免费学习笔记（深入）”；
-
filemtime()返回false时不会提供错误原因，建议搭配is_readable()预检 -
stat()在某些 NFS 或容器挂载卷上可能因缓存行为返回过期值，filemtime()同样受影响，这不是函数问题，是底层文件系统特性
判断文件是否被修改过的实用写法
单纯获取时间没意义，多数场景是要做“是否变更”的逻辑判断，比如热加载配置、跳过未改动的缓存文件。
关键不是比时间戳大小，而是比“有没有变”——所以应保存上次的 filemtime() 结果（如写入 Redis 或本地临时文件），下次读出来对比：
- 避免每次用
time() - filemtime($f) 这类“距今多久”的写法，它无法应对系统时间回拨或手动改系统时间的情况 - 如果文件可能被删除后重建（如日志轮转），仅靠
filemtime()不足以确认内容一致，此时要加md5_file()或crc32(file_get_contents())辅助校验 - 在 CLI 脚本中要注意 opcache 可能缓存
filemtime()结果（尤其启用了opcache.enable_cli=1），可用clearstatcache(true, $filepath)强制刷新
Windows 下的注意事项
Windows 文件系统（NTFS/FAT）默认不更新 atime，但 mtime 是可靠的；不过有个隐藏坑：资源管理器里“修改日期”显示的可能是“写入时间”，而 filemtime() 拿到的是内核级 st_mtime，二者在某些第三方同步工具或压缩包解压场景下可能不一致。
验证方法很简单：用命令行 dir /T:W 查看 Windows 的“写入时间”，和 PHP 输出的 date('Y-m-d H:i:s', filemtime($f)) 对比是否一致。
- 不要依赖 Windows 资源管理器右键属性里的“修改日期”来调试，它受视图设置、区域格式、甚至 Explorer 缓存影响
- 如果发现
filemtime()总是返回 1970-01-01，大概率是文件路径错误或权限不足，先检查is_file($f) && is_readable($f)
实际用的时候，最常被忽略的是缓存行为和权限预检——不是函数不好用，而是没意识到它对文件状态的敏感性。
