如何让WordPress插件注释版本号与代码变量自动同步？

你可以通过以下几种方式实现注释头部Version字段和代码中$version变量的自动同步，无需手动修改两处：

1. 使用独立配置文件+同步脚本（推荐） #

通过单独维护版本号，再用脚本同步到注释和变量中：

• 创建一个仅存版本号的配置文件，比如version.php：

<?php
return '1.0.0';
?>

• 在主插件文件中引入这个配置来定义变量：

$version = require 'version.php';

• 编写简单的PHP同步脚本，读取配置文件的版本号，自动替换插件头部注释的Version字段：

<?php
$versionFile = 'version.php';
$pluginFile = 'cart-discount.php';

// 读取当前版本号
$version = trim(str_replace(['<?php', 'return', ';', "'", '"'], '', file_get_contents($versionFile)));

// 读取插件文件内容并替换版本字段
$content = file_get_contents($pluginFile);
$content = preg_replace('/Version:\s+([0-9.]+)/', "Version:           {$version}", $content);

// 写回修改后的内容
file_put_contents($pluginFile, $content);
?>

每次更新版本时，只修改version.php，运行脚本就能自动同步注释和变量。

2. 动态从注释读取版本号 #

如果仅需要在功能逻辑中使用统一版本号，可以直接从插件头部注释读取，无需单独定义变量：

// 从当前插件文件的头部注释中获取版本号
$plugin_data = get_file_data(__FILE__, ['Version' => 'Version']);
$version = $plugin_data['Version'];

这样只需维护注释里的Version字段，代码中的$version会自动同步。

3. 借助Git钩子/CI流程自动化 #

如果用Git管理代码，可以在提交钩子或CI流水线中加入同步步骤：

• 比如在Git的pre-commit钩子中运行上述同步脚本，确保每次代码提交前版本号已同步。

内容的提问来源于stack exchange，提问作者Nymul Islam Moon