不推荐直接改文件名后缀加版本号，因需同步更新HTML引用、构建部署须原子性，PHP运行时重命名易致并发冲突、opcache缓存旧名或Web服务器404；推荐用filemtime()加查询参数并配合理想缓存头。
为什么直接改文件名后缀加版本号在 PHP 中不推荐
因为浏览器和 CDN 会缓存
这类带查询参数的 URL，但对
这种真实文件名变更，需要同步更新 HTML 中所有引用，且构建/部署时必须确保文件生成、重命名、路径替换原子性。PHP 本身不参与构建流程，硬靠它动态重命名静态资源容易出错——比如并发请求下写入冲突、
缓存旧文件名、或 Apache/Nginx 没配置好导致 404。
用 PHP 生成时间戳查询参数并控制缓存头
最轻量、兼容性最好的做法：PHP 不改文件名，只在输出 HTML 时给资源 URL 加上
时间戳作为查询参数，并设置合理的响应头。这样既避免文件系统操作，又能让浏览器在文件变更时自动失效缓存。
常见错误是只加参数不设缓存策略，导致每次请求都走 PHP 而不是强缓存。正确做法：
用
获取文件最后修改时间，转成秒级整数（避免浮点误差）：
在 Web 服务器层（如 Nginx）配置对
、
等静态资源返回
，让浏览器长期缓存；而 PHP 输出的 HTML 本身用短缓存（如
）或不缓存
注意
前加
抑制文件不存在时的警告，否则开发环境报错会暴露路径
如果真要生成带版本号的物理文件（如构建场景）
适合 CI/CD 或本地构建脚本中调用 PHP 批量处理，而非运行时动态做。关键点是别用时间戳当文件名主体（如
），而应基于内容哈希——否则文件内容没变但时间戳变了，缓存就白费了。
立即学习
“
PHP免费学习笔记（深入）
”；
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
实操建议：
用
计算文件内容哈希，取前 8 位即可：
生成新文件名时保留原始扩展名，用点分隔：
复制而非重命名原文件，防止源文件被意外覆盖：
HTML 中引用需同步替换，不能靠运行时 PHP 查——构建后就该是确定的路径，建议用模板变量或构建工具注入
PHP 配合 Apache/Nginx 实现透明重写（零修改 HTML）
当已有大量
引用无法改代码，又想启用版本管理时，可让服务器把带哈希的请求（如
）自动映射回原始文件。PHP 只负责生成映射关系（如写 JSON 文件），不参与请求分发。
步骤：
构建脚本用 PHP 扫描
目录，生成
：
Apache 用
或 Nginx 用
将
重写为
PHP 运行时不再参与 URL 生成，只读取
做开发调试用（比如检查某哈希对应哪个源文件）
这种方案的坑在于：正则匹配要严格，避免误伤真实含点的路径；Nginx 的
必须配
标志才能触发内部重定向；重写规则要放在静态资源 location 块里，不能放全局 server 块。
style.css?v=1.2style.v1.2.cssopcachefilemtime()filemtime()
.css.jsCache-Control: public, max-age=31536000max-age=60@filemtime()@style.1718234567.cssmd5_file()$hash = substr(md5_file('src/style.css'), 0, 8);$newName = 'style.' . $hash . '.css';copy('src/style.css', 'dist/' . $newName);style.cssstyle.a1b2c3d4.csssrc/rev-manifest.json{"style.css": "style.a1b2c3d4.css", "app.js": "app.f5e6d7c8.js"}RewriteRuletry_files/(.*)\.[0-9a-f]{8}\.(css|js)$/$1.$2rev-manifest.jsontry_fileslast