You need to enable JavaScript to run this app. WP插件upgrader_process_complete钩子自动更新时不生效怎么办
优惠活动
大模型
产品
解决方案
定价
更多

WP插件upgrader_process_complete钩子自动更新时不生效怎么办

现有实现适配性结论

当前实现无法可靠适配插件自动更新场景,核心原因如下:

  • 钩子注册时机问题:当前钩子绑定在插件自身的代码逻辑中,自动更新流程多由无用户上下文的WP Cron静默触发,如果你的插件仅在后台登录场景下才加载主逻辑、注册钩子,自动更新请求中根本不会执行add_action代码,自然无法触发回调。
  • 自身更新的文件替换问题:当自动更新的对象就是当前插件本身时,旧版本插件文件会在更新流程中被替换,若新版本重构了类名、回调函数定义,原内存中绑定的回调引用会直接失效。
  • 运行上下文差异:自动更新流程中WordPress会切换到最小运行环境(如临时切换默认主题、跳过非必要请求处理),手动更新场景下的权限、用户会话依赖在自动更新中不存在,也会导致回调执行失败。
可行替代实现方案

方案1:版本号检测迁移(最可靠,推荐)

不依赖更新流程的钩子,通过对比存储的插件版本和代码内置版本,判断是否刚完成更新并触发自定义操作,完全兼容所有更新场景。

  • 实现逻辑:
    1. 在插件主文件顶部定义当前代码的版本常量
    2. 插件每次加载时(前台、后台、Cron请求都会触发)读取数据库存储的旧版本号
    3. 对比两个版本,若代码版本更高,说明刚完成更新,执行自定义操作后更新存储的版本号
  • 示例代码:
// 插件主文件最顶部定义
define( 'MY_PLUGIN_VERSION', '1.2.3' );
define( 'MY_PLUGIN_DB_VERSION_OPTION', 'my_plugin_stored_version' );

// 绑定到init钩子,所有请求加载时都会执行检测
add_action( 'init', 'my_plugin_check_version_update' );
function my_plugin_check_version_update() {
    $stored_version = get_option( MY_PLUGIN_DB_VERSION_OPTION, '0.0.0' );
    // 用语义化版本对比,避免字符串排序误差
    if ( version_compare( $stored_version, MY_PLUGIN_VERSION, '<' ) ) {
        // 在此处执行你的自定义操作,如:
        // 更新数据库表结构、重置缓存、迁移旧配置等
        
        // 执行完成后更新存储版本,避免重复触发
        update_option( MY_PLUGIN_DB_VERSION_OPTION, MY_PLUGIN_VERSION );
    }
}

方案2:将更新回调注册到必用插件(mu-plugins)

mu-plugins目录下的文件是WordPress每次请求都会无条件加载的,不受插件更新、环境切换的影响,从根源上解决钩子注册时机问题。

  • 实现逻辑:
    1. 在wp-content/mu-plugins/目录下新建独立PHP文件,如my-plugin-update-handler.php
    2. 在该文件中注册upgrader_process_complete钩子,判断目标插件是否完成更新后执行自定义操作
  • 示例代码:
// wp-content/mu-plugins/my-plugin-update-handler.php
add_action( 'upgrader_process_complete', 'my_plugin_handle_update', 10, 2 );
function my_plugin_handle_update( $upgrader_object, $options ) {
    // 替换为你自己的插件基础路径,如xxx/xxx.php
    $target_plugin_path = 'my-plugin/my-plugin.php';
    
    if ( $options['action'] === 'update' && $options['type'] === 'plugin' ) {
        foreach ( $options['plugins'] as $updated_plugin ) {
            if ( $updated_plugin === $target_plugin_path ) {
                // 在此处执行自定义操作
                break;
            }
        }
    }
}
  • 注意:mu-plugins的代码不会随你的插件更新自动修改,需要提前写死插件路径,避免插件目录、主文件改名后判断失效。

方案3:现有逻辑适配排查

如果不想替换现有实现,可按以下方向排查修复自动更新失效问题:

  • 确保add_action的注册逻辑放在插件主文件最顶部,不要嵌入后台专属逻辑、条件类加载分支中,保证所有请求(包括Cron、自动更新)都会执行注册
  • 排查回调逻辑中是否依赖后台管理员权限、当前用户会话、is_admin()类判断,自动更新无登录用户上下文,需移除这类依赖
  • 打印自动更新场景下的$options参数到日志,确认$options['plugins']的路径格式和你用plugin_basename(__FILE__)生成的格式一致,避免路径不匹配导致判断失效

内容的提问来源于stack exchange,提问作者Mahidul Islam

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 06:45:04