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