WP插件upgrader_process_complete钩子自动更新时不生效怎么办
现有实现适配性结论
当前实现无法可靠适配插件自动更新场景,核心原因如下:
- 钩子注册时机问题:当前钩子绑定在插件自身的代码逻辑中,自动更新流程多由无用户上下文的WP Cron静默触发,如果你的插件仅在后台登录场景下才加载主逻辑、注册钩子,自动更新请求中根本不会执行
add_action代码,自然无法触发回调。 - 自身更新的文件替换问题:当自动更新的对象就是当前插件本身时,旧版本插件文件会在更新流程中被替换,若新版本重构了类名、回调函数定义,原内存中绑定的回调引用会直接失效。
- 运行上下文差异:自动更新流程中WordPress会切换到最小运行环境(如临时切换默认主题、跳过非必要请求处理),手动更新场景下的权限、用户会话依赖在自动更新中不存在,也会导致回调执行失败。
可行替代实现方案
方案1:版本号检测迁移(最可靠,推荐)
不依赖更新流程的钩子,通过对比存储的插件版本和代码内置版本,判断是否刚完成更新并触发自定义操作,完全兼容所有更新场景。
- 实现逻辑:
- 在插件主文件顶部定义当前代码的版本常量
- 插件每次加载时(前台、后台、Cron请求都会触发)读取数据库存储的旧版本号
- 对比两个版本,若代码版本更高,说明刚完成更新,执行自定义操作后更新存储的版本号
- 示例代码:
// 插件主文件最顶部定义 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每次请求都会无条件加载的,不受插件更新、环境切换的影响,从根源上解决钩子注册时机问题。
- 实现逻辑:
- 在
wp-content/mu-plugins/目录下新建独立PHP文件,如my-plugin-update-handler.php - 在该文件中注册
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
相关产品推荐
相关产品推荐

