图片URL不变但内容未更新的首要原因是opcache缓存文件元信息,导致filemtime()等函数返回旧值;其次需排查Web服务器open_file_cache或EnableSendfile、CDN/浏览器缓存及NFS等挂载导致mtime不更新问题。
图片 URL 不变但内容没更新,先查 opcache 是否启用并缓存了文件元信息
很多主机默认开启 opcache,它不仅缓存 PHP 字节码,还会缓存 file_exists()、is_file()、filemtime() 等文件系统函数的返回结果。这意味着即使你替换了图片文件,PHP 仍可能读到旧的修改时间或误判文件不存在。
- 用
phpinfo()检查opcache.enable和opcache.enable_cli是否为On - 关键配置项:
opcache.revalidate_freq=2(默认 2 秒)会导致最多延迟 2 秒才感知文件变化;设为0可禁用时效检查(仅开发环境用) - 临时验证:在代码开头加
opcache_invalidate(__FILE__, true);看是否立刻生效;生产环境切勿长期依赖此调用
filemtime() 返回时间戳不准?确认时区与文件系统挂载选项
不同主机的系统时区、磁盘挂载参数(如 noatime、relatime)会影响 filemtime() 行为,尤其当图片通过 rsync 或 CI/CD 覆盖部署时,部分系统可能不更新 mtime。
- 执行
stat your-image.jpg对比命令行输出的Modify:时间与 PHP 中echo filemtime('your-image.jpg');输出是否一致 - 若不一致,检查 PHP 时区:
date_default_timezone_get()应与系统一致(如Asia/Shanghai),否则date()格式化后看起来“错位” - NFS 或某些容器卷挂载可能禁用 mtime 更新,此时应改用文件内容哈希(如
md5_file())作版本标识,而非依赖时间戳
Web 服务器层缓存干扰:Nginx 的 open_file_cache 和 Apache 的 EnableSendfile
即使 PHP 正确读取了新文件,Web 服务器也可能因自身缓存机制返回旧响应体或 304 Not Modified。