PHP获取文件最后修改时间怎么做_PHP时间戳转换可读日期指南【说明】

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 同步，这个“最后修改时间”连秒级都不准。