WordPress插件更新时如何执行update_option？推荐实现方案咨询

你说得没错，register_activation_hook确实只在插件首次安装或者手动重新激活时触发，插件通过WordPress更新流程升级时完全不会碰这个钩子，所以需要单独处理更新场景的初始化操作。下面是两种最常用的解决方案，其中第一种是行业内的推荐首选：

方法一：通过版本号跟踪执行更新逻辑（推荐） #

这个思路的核心是：在插件里记录当前的版本号，每次插件加载时，对比当前版本和数据库中存储的旧版本——如果新版本更高，就执行需要的更新操作，然后把新版本号存入数据库，避免重复执行。这种方法不受更新方式限制，不管用户是自动更新、手动上传压缩包更新，甚至直接替换文件，只要版本号变了就会触发，可靠性拉满。

具体实现代码示例：

// 在插件主文件顶部定义当前版本号（记得每次更新插件时同步修改这个值）
define('MY_CUSTOM_PLUGIN_VERSION', '1.2.0');

/**
 * 检查插件版本并执行更新操作
 */
function my_custom_plugin_run_updates() {
    // 获取数据库中存储的旧版本号，默认值设为低于初始版本的数值
    $saved_version = get_option('my_custom_plugin_version', '0.1.0');

    // 使用WordPress内置的version_compare函数比较版本号
    if (version_compare(MY_CUSTOM_PLUGIN_VERSION, $saved_version, '>')) {
        // --------------------------
        // 这里写你的更新操作，比如设置新选项
        update_option('my_plugin_new_setting', 'default_value');
        // 如果有多个更新步骤，可以按版本分段处理，比如针对1.1.0、1.2.0分别做不同操作
        // --------------------------

        // 更新数据库中的版本号，确保下次加载不会重复执行
        update_option('my_custom_plugin_version', MY_CUSTOM_PLUGIN_VERSION);
    }
}
// 绑定到plugins_loaded钩子，确保插件已加载，选项函数可用
add_action('plugins_loaded', 'my_custom_plugin_run_updates');

这种方法的优势：

• 覆盖所有更新场景，不受WordPress升级流程限制
• 可以灵活处理多版本迭代的更新需求（比如不同版本需要执行不同的数据库操作）
• 逻辑清晰，容易维护

方法二：使用upgrader_process_complete钩子 #

这个钩子是WordPress升级器完成升级操作（包括插件、主题、核心）时触发的，你可以在里面判断是否是当前插件的更新，然后执行操作。但它的局限性是：只有通过WordPress官方升级流程更新时才会触发，如果用户手动替换插件文件，这个钩子不会执行，所以只能作为补充方案，不建议单独使用。

代码示例：

/**
 * 在插件更新完成后执行操作
 */
function my_custom_plugin_on_update($upgrader, $options) {
    // 只处理插件更新操作
    if ($options['action'] !== 'update' || $options['type'] !== 'plugin') {
        return;
    }

    // 获取当前插件的basename（比如my-plugin/my-plugin.php）
    $current_plugin = plugin_basename(__FILE__);

    // 检查本次更新的插件列表中是否包含当前插件
    if (in_array($current_plugin, $options['plugins'])) {
        // 执行你的更新操作
        update_option('my_plugin_new_setting', 'default_value');
    }
}
// 绑定钩子，注意要传2个参数
add_action('upgrader_process_complete', 'my_custom_plugin_on_update', 10, 2);

总结 #

优先选择版本号跟踪的方法，它能覆盖所有可能的更新场景，是WordPress插件开发者处理版本迭代更新的标准做法。upgrader_process_complete可以作为辅助，但不能替代版本跟踪的核心逻辑。

内容的提问来源于stack exchange，提问作者Gijo Varghese