filemtime() 返回unix时间戳而非可读字符串，需用date()等转换；失败时返回false，须显式判断；精度仅秒级，依赖服务器时钟同步。
filemtime() 返回的是时间戳，不是可读字符串
PHP 里最直接获取文件最后修改时间的函数是 filemtime()，但它返回的是 Unix 时间戳（整数），比如 1717023456。直接 echo 它只会输出一串数字，不是“2024-05-30 14:30:22”这种格式。
常见错误现象：代码写成 echo filemtime('config.php');，结果页面只显示一长串数字，还以为函数出错了。
- 必须用
date()或DateTime转换才能得到可读日期 -
filemtime()在文件不存在或权限不足时会返回false，不加判断直接传给date()会触发警告 - Windows 系统下 NTFS 卷可能因缓存导致
filemtime()暂时滞后几秒（尤其在频繁写入场景）
简单安全写法：
$time = filemtime('data.json');<br>echo $time ? date('Y-m-d H:i:s', $time) : '文件不可读';
date() 格式字符串别硬记，按需组合最稳
把时间戳转成可读格式，核心是 date() 的第一个参数——格式字符串。不用背全表，记住几个高频组合就行：
立即学习“PHP免费学习笔记（深入）”；
-
'Y-m-d'→2024-05-30（年月日，短横分隔） -
'Y-m-d H:i:s'→2024-05-30 14:30:22（带时分秒，空格分隔） -
'M j, Y'→May 30, 2024（英文月份，适合前端展示） -
'c'→2024-05-30T14:30:22+08:00（ISO 8601，兼容 JSON 和 API）
注意：H 是 24 小时制，h 是 12 小时制；i 是分钟（不是 m，那是月份）；s 是秒。写错字母会出意料之外的结果，比如 date('Y-m-d h:i:s') 可能显示 2024-05-30 02:30:22 而不是 14:30:22。
filemtime() 失败时不要静默吞掉错误
调用 filemtime() 出错很常见：路径写错、文件被删、open_basedir 限制、SELinux 策略拦截……它失败时返回 false，但不会抛异常。
- 直接对
false调用date()会报Warning: date(): Invalid date format - 用
@filemtime()屏蔽警告只是掩盖问题，不利于调试 - 建议显式判断并记录上下文，比如：
$path = '/var/www/uploads/backup.zip';<br>$ts = filemtime($path);<br>if ($ts === false) {<br> error_log("filemtime failed for {$path}: " . error_get_last()['message']);<br> $display_time = '未知';<br>} else {<br> $display_time = date('Y-m-d H:i', $ts);<br>}
需要毫秒精度？filemtime() 不行，得换方案
filemtime() 只精确到秒，在 Linux/ext4 或 Windows NTFS 上，即使文件每秒都改，你也看不到毫秒级变化。
如果真需要更高精度（比如审计日志、冲突检测），有两条路：
- 改用
stat()查mtime字段，但它仍是秒级；PHP 8.2+ 才支持stat()的纳秒字段（mtime_nsec），且底层文件系统未必提供 - 更实际的做法：在写文件时，用
file_put_contents()+date('c')把时间戳写进文件头或配套的.meta文件里，自己维护精度
别为了“看起来更准”强行上复杂方案——绝大多数 Web 场景，“最后修改时间”只要秒级就足够可信。真正容易被忽略的是：时间戳本身依赖服务器时钟，如果服务器没跑 NTP 同步，这个“最后修改时间”连秒级都不准。
