Composer主项目与自定义插件的依赖版本冲突解决方案咨询

针对主项目和自定义插件依赖同包不同版本、需要让插件加载自身vendor依赖的需求，给你几个比imposter-plugin更优雅的方案：

方案一：自定义安装路径 + 自动加载优先级控制 #

在插件的composer.json里指定独立的vendor目录，并调整自动加载规则，让插件优先加载自身的依赖：

1. 配置插件的vendor目录和安装路径：

{
  "config": {
    "vendor-dir": "vendor", // 插件自身的vendor目录，和主项目隔离
    "installer-paths": {
      "vendor/{$vendor}/{$name}": ["*"]
    }
  },
  "autoload": {
    "psr-4": {
      "YourPluginNamespace\\": "src/"
    },
    "files": ["vendor/autoload.php"] // 提前加载自身的自动加载文件
  }
}

2. 在插件的入口初始化代码中，手动引入自身的vendor/autoload.php，并利用spl_autoload_register设置更高的加载优先级：

// 插件初始化文件
$pluginAutoloader = require __DIR__ . '/vendor/autoload.php';
// 将插件的自动加载器设为最高优先级
spl_autoload_register([$pluginAutoloader, 'loadClass'], true, true);

优点：无需额外工具，配置简单；缺点：如果依赖包存在全局函数或常量冲突，无法解决。

方案二：依赖命名空间前缀隔离（推荐） #

给插件的所有依赖类添加专属命名空间前缀，让插件的依赖类与主项目的完全区分开：

1. 在插件项目中安装php-scoper工具：

composer require --dev humbug/php-scoper

2. 创建scoper.inc.php配置文件，指定插件的命名空间前缀（比如YourPlugin\Dependencies\），并配置不需要前缀化的插件自身代码：

// scoper.inc.php
return [
    'prefix' => 'YourPlugin\\Dependencies\\',
    'whitelist' => [
        'YourPluginNamespace\\*' // 插件自身的代码不需要前缀化
    ],
    'patchers' => [],
];

3. 执行前缀化命令，处理插件的依赖和代码：

vendor/bin/php-scoper add-prefix

4. 发布插件时，使用处理后的代码（默认生成在build/目录），此时插件的依赖类都会带上专属前缀，和主项目的同包类完全不冲突。
   优点：彻底解决所有依赖冲突，包括全局函数、常量；缺点：需要额外的构建步骤，适合需要发布的正式插件。

方案三：临时切换自动加载器（谨慎使用） #

在插件初始化时，临时移除主项目的自动加载器，加载完插件依赖后再恢复：

// 插件入口文件
// 保存主项目的自动加载器
$originalLoaders = spl_autoload_functions();
// 移除所有自动加载器
foreach ($originalLoaders as $loader) {
    spl_autoload_unregister($loader);
}

// 加载插件自身的依赖
require __DIR__ . '/vendor/autoload.php';

// 恢复主项目的自动加载器
foreach ($originalLoaders as $loader) {
    spl_autoload_register($loader);
}

优点：无需修改依赖结构；缺点：风险较高，若主项目的自动加载器包含有状态的逻辑，恢复后可能出现异常，仅适合测试场景或简单项目。

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