ThinkPHP如何做静态资源版本控制_ThinkPHP防止浏览器缓存旧文件【教程】-ThinkPHP-PHP中文网

ThinkPHP静态资源版本号需通过配置static_version并拼入URL实现，推荐用filemtime()或Git哈希生成，配合Nginx/Apache对JS/CSS设置长期缓存头，同时排查浏览器、代理及CDN是否识别新版本号。

thinkphp如何做静态资源版本控制_thinkphp防止浏览器缓存旧文件【教程】

直接改 config/app.php 里的 app_debug 或靠手动改文件名，不是真解法。ThinkPHP 自带的静态资源管理机制（__STATIC__、__CSS__ 等）默认不带版本控制，必须自己接管 URL 生成逻辑。

核心做法是：用时间戳或 Git 提交哈希作为版本参数，拼在静态资源 URL 后面，比如 /static/js/app.js?v=20240520。但不能硬编码，得让模板函数自动注入。

推荐在 config/app.php 中新增配置项：'static_version' => date('YmdHi', filemtime(ROOT_PATH . 'public/static/'))（仅开发环境可用；生产环境建议换成 git rev-parse --short HEAD 脚本输出）
在公共模板里把 __STATIC__ 替换为带版本的路径：用 {:config('app.static_version')} 拼接，例如
别依赖浏览器自动缓存刷新——app_debug=true 时 ThinkPHP 会禁用部分缓存头，反而掩盖问题；上线前务必关掉 app_debug 并验证响应头中 Cache-Control 是否生效

time() 每次请求都变，等于废掉所有浏览器缓存；filemtime() 只在文件真实修改时更新，兼顾缓存效率和更新可靠性。

但要注意：ThinkPHP 的 public/static/ 目录下如果存在子目录嵌套（如 public/static/admin/js/），只取根目录 filemtime 就会漏判——某个 JS 文件改了，但整体目录时间没变，版本号就不动。

更稳的做法是计算关键文件的最新修改时间，例如：max(filemtime('public/static/js/app.js'), filemtime('public/static/css/app.css'))
如果用构建工具（Webpack/Vite），应该让构建脚本把哈希写入一个 version.json，PHP 读它而不是反复 stat 文件，避免 I/O 开销
注意 Windows 下 filemtime 精度只有 1 秒，高频发布时可能撞时间——此时必须切到 Git 哈希方案

光 PHP 加 v=xxx 不够，服务器必须正确设置响应头，否则浏览器根本不会发带版本号的新请求。

典型错误是：HTML 页面返回了 Cache-Control: no-cache，但 JS 文件也跟着被设成不缓存，导致每次都要重下——其实你只想让 HTML 不缓存，JS/CSS 必须长期缓存。

nginx 配置里要区分路径：location ~* \.(js|css|png|jpg|gif|ico)$ { add_header Cache-Control "public, max-age=31536000"; }
同时确保 HTML 相关 location（如 location / 或 location ~ \.php$）没有继承上面的缓存头，否则 JS 也会被误设
Apache 用户注意：.htaccess 中的 ExpiresByType 对 PHP 输出的 HTML 无效，只对静态文件生效；动态页面的缓存头必须由 PHP 或 Web 服务器主配置控制

不是“清缓存就能好”，而是有固定排查链路。90% 的情况卡在其中一环。

看浏览器开发者工具 Network 标签页，点开那个旧 JS 文件，确认 Request URL 里的 v= 参数是否真的变了——没变说明 PHP 没重新生成版本号，或者模板没刷新
检查该 JS 文件响应头中的 ETag 和 Last-Modified：如果这两个还在，即使 URL 带新 v=，某些代理或中间网关仍可能返回 304，导致内容没更新
确认 CDN 是否缓存了旧 URL（比如阿里云 CDN 默认缓存所有静态路径）：哪怕你改了 PHP 版本号，CDN 还拿着 /static/js/app.js?v=20240519 的副本，新请求 v=20240520 它可能根本没刷到——得主动提交 URL 刷新或调高缓存键精度

版本号本身只是个标记，真正起作用的是整个链路上每个环节是否把它当回事。少一个地方认它，就白加。