两个WordPress插件共用同一Composer包的版本冲突解决咨询

Composer端配置方案 #

1. 自定义自动加载规则，强制加载自身vendor类 #

在每个插件的composer.json里，针对共用包设置独立的类映射或PSR-4前缀，确保插件优先加载自己vendor目录下的类文件。

比如插件B的composer.json可以这么写：

{
  "autoload": {
    "classmap": ["vendor/your-vendor/your-shared-package/src/"]
  }
}

修改后执行composer dump-autoload更新自动加载文件，这样插件B会直接从自己的vendor目录加载共用包的类，不会复用其他插件已加载的版本。

2. 用provide声明包版本（应急方案） #

如果不想修改自动加载规则，可以在每个插件的composer.json里添加provide配置，声明自己已经提供了特定版本的共用包，避免Composer的冲突检测，但注意这种方式不能保证类隔离，仅适合插件间不会互相调用共用包类的场景：

{
  "provide": {
    "your-vendor/your-shared-package": "1.0.1"
  }
}

WordPress端处理方案 #

1. 延迟加载并自定义自动加载优先级 #

不要在插件主文件开头直接引入vendor/autoload.php，而是通过plugins_loaded钩子在插件初始化时加载，并且手动调整自动加载器的命名空间映射，确保自己的共用包类优先被加载。

比如插件B的主文件代码：

add_action('plugins_loaded', function() {
    // 加载自身的自动加载器
    $autoloader = require_once plugin_dir_path(__FILE__) . 'vendor/autoload.php';
    // 手动注册共用包的命名空间映射，覆盖全局设置
    $autoloader->addPsr4('YourSharedPackage\\', plugin_dir_path(__FILE__) . 'vendor/your-vendor/your-shared-package/src/');
}, 1); // 设置高优先级，确保自己的自动加载规则先生效

2. 利用WordPress自动加载钩子指定类路径 #

针对共用包的关键类，通过wp_autoload钩子手动指定加载路径，强制插件使用自己vendor里的版本：

add_filter('wp_autoload', function($class) {
    // 匹配共用包的类名
    $shared_classes = [
        'YourSharedPackage\\ClassA',
        'YourSharedPackage\\ClassB'
    ];
    if (in_array($class, $shared_classes)) {
        $file_path = plugin_dir_path(__FILE__) . 'vendor/your-vendor/your-shared-package/src/' . str_replace('\\', '/', $class) . '.php';
        if (file_exists($file_path)) {
            require_once $file_path;
            return true;
        }
    }
    return false;
});

核心逻辑 #

本质是让每个插件的自动加载器拥有类加载的优先级，避免全局自动加载器复用其他插件已加载的旧版本类。优先推荐Composer端的自定义自动加载+WordPress钩子延迟加载的组合方案，既能保证版本隔离，又不会干扰WordPress的整体运行。

内容的提问来源于stack exchange，提问作者Araqel Araqelyan