LAMP站点如何在文件变更时自动递增全局版本号？

我之前维护LAMP站点时也碰到过一模一样的需求——手动改版本号太繁琐还容易忘，而且绝对不能每次请求都扫文件拖慢性能。下面几个方案亲测好用，完全符合你的要求：

方案一：部署时生成文件哈希版本号（最推荐） #

核心思路是把版本计算放在部署阶段，运行时只读取预先生成好的版本值，零性能损耗。

• 写一个简单的部署脚本（PHP或Shell都可以），逻辑如下：
  1. 遍历你需要监控的文件目录（比如/src/php、/assets/js、/assets/css）
  2. 计算这些文件内容的整体MD5哈希（或者取所有文件中最新的修改时间戳）
  3. 把计算出的版本值写入一个全局配置文件，比如config/site_version.php，内容示例：

     <?php
     define('SITE_VERSION', 'a1b2c3d'); // 这里是计算出的哈希值
     ?>
     

• 站点运行时，只需要引入这个配置文件，直接用SITE_VERSION作为全局版本号
• 前端可以通过PHP把这个变量输出到JS中：

  <script>
    const siteVersion = '<?= SITE_VERSION ?>';
    // 这里写你的版本对比刷新逻辑
  </script>
  

这个方案的优势是：运行时完全不消耗额外资源，版本号和文件内容强绑定，只要文件变了版本就会更新，绝对不会漏。

方案二：用Git提交哈希当版本号（适合Git管理的项目） #

如果你的代码用Git管理，那直接用当前提交的哈希值当版本号是最省事的——Git哈希本身就代表了当前代码的唯一状态，文件变了哈希肯定变。

• 部署时执行命令git rev-parse --short HEAD获取短哈希（比如a1b2c3d）
• 把这个哈希写入配置文件，或者在PHP中通过安全的方式获取（比如部署脚本写入，不要在每个请求里执行Git命令）
• 同样把这个值传递给前端，用于对比刷新

这个方案不用自己写文件扫描逻辑，利用Git的天然版本标识，可靠性拉满，而且部署时自动更新，完全不用手动干预。

方案三：定时监控文件变更（适合无构建工具的小站点） #

如果不想用构建工具或Git，也可以用后台定时任务来监控文件，只在文件变更时更新版本号：

• 创建一个version_cache.txt文件，里面存储当前版本号和上次监控的文件哈希
• 写一个PHP脚本，定时通过cron运行：
  1. 计算监控文件的整体哈希
  2. 和version_cache.txt里的旧哈希对比
  3. 如果不一致，就递增版本号（或者生成新哈希），更新version_cache.txt
• 站点运行时只读取这个缓存文件里的版本号

这个方案运行时也不会消耗资源，只有定时任务会做一次检查，适合小型站点快速实现。

额外注意事项 #

• 把版本号加到静态资源URL上，比如/css/style.css?v=<?= SITE_VERSION ?>，这样浏览器会自动缓存新版本，避免用户看到旧内容
• 绝对不要在每个PHP请求中去扫描文件或计算哈希，那样才会导致资源过度消耗——所有版本计算都要放在部署阶段或后台定时任务里完成

内容的提问来源于stack exchange，提问作者Ryan Griggs