如何让Composer复用已有依赖包，避免重复下载？

我正在基于league/omnipay构建一套模块化支付网关插件，目录结构如下：

plugins/core_module
plugins/gateway_paypal
plugins/gateway_stripe
plugins/...

核心模块的composer.json配置：

{
    "require": {
        "league/omnipay": "^3.2"
    },
    "config": {
        "allow-plugins": {
            "php-http/discovery": true
        }
    }
}

执行composer require/update后，依赖会下载到plugins/core_module/vendor/目录。

以PayPal网关插件为例，其composer.json配置：

{
    "require": {
        "league/omnipay": "^3.2",
        "omnipay/paypal": "^3.0"
    }
}

问题：网关插件会重复下载核心模块已有的league/omnipay依赖到自身vendor目录，我希望Composer能识别核心已有的依赖，仅下载网关特有的依赖。

我尝试过配置path类型仓库，但无效：

...
    "repositories": [
    {
      "type": "path",
      "url": "../core_module/vendor/omnipay"
    }
  ],
...

也考虑过将网关插件的vendor-dir指向核心模块的vendor目录，但会导致依赖混杂，不利于后续移除插件。

可行解决方案 #

方案1：根目录统一管理所有插件依赖（推荐） #

在plugins目录下创建一个根级composer.json，将所有插件作为本地路径仓库引入，由Composer统一管理依赖树，自动复用共享依赖。

根级plugins/composer.json配置：

{
    "require": {
        "your/core-module": "@dev",
        "your/gateway-paypal": "@dev",
        "your/gateway-stripe": "@dev"
    },
    "repositories": [
        {
            "type": "path",
            "url": "./core_module"
        },
        {
            "type": "path",
            "url": "./gateway_paypal"
        },
        {
            "type": "path",
            "url": "./gateway_stripe"
        }
    ],
    "config": {
        "allow-plugins": {
            "php-http/discovery": true
        }
    }
}

每个插件的composer.json无需修改，保持原有声明：

• 核心模块保留对league/omnipay的依赖
• 网关插件保留对league/omnipay和对应网关包的依赖

优势：

• Composer会自动合并所有依赖，仅下载一份league/omnipay到根目录的vendor
• 插件完全独立，移除插件只需从根composer.json中删除对应require项，执行composer update即可清理相关依赖
• 开发和生产环境依赖管理一致，无额外风险

方案2：网关插件仅在开发阶段声明核心依赖 #

将网关插件中league/omnipay的依赖从require移到require-dev，开发阶段用于代码提示和测试，生产环境依赖核心模块已加载的league/omnipay类。

修改后的网关插件composer.json：

{
    "require": {
        "omnipay/paypal": "^3.0"
    },
    "require-dev": {
        "league/omnipay": "^3.2"
    }
}

注意：必须确保运行时核心模块先于网关插件加载，否则会出现类找不到的错误。

优势：网关插件的生产依赖仅包含自身特有的包，避免重复下载；开发阶段仍能正常使用核心依赖做开发。

方案3：使用replace属性声明复用核心依赖（不推荐） #

在网关插件的composer.json中添加replace属性，声明自身提供了league/omnipay的实现，从而跳过依赖下载。

修改后的网关插件composer.json：

{
    "require": {
        "omnipay/paypal": "^3.0"
    },
    "replace": {
        "league/omnipay": "^3.2"
    }
}

风险：如果核心模块的league/omnipay版本与网关插件声明的replace版本不匹配，会导致运行时兼容性问题；且依赖关系不透明，后期维护难度大。

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