如何用Composer实现单包可选择分段加载及冲突处理？

1. 能否通过Composer实现单包可选择分段加载？ #

可以，推荐两种实用方案：

方案一：自定义自动加载过滤脚本 #

在你的包的composer.json中，先通过PSR-4规则定义所有模块的自动加载路径，再添加自定义extra字段标记所有模块，最后编写一个自动加载过滤脚本，在Composer的post-autoload-dump事件中执行，根据项目端的配置筛选要加载的模块。

示例配置：

{
  "name": "your/measurement-package",
  "autoload": {
    "psr-4": {
      "Your\\Measurement\\": "src/"
    }
  },
  "extra": {
    "measurement-modules": ["Length", "Power", "Weight"]
  },
  "scripts": {
    "post-autoload-dump": "Your\\Measurement\\AutoloadFilter::apply"
  }
}

AutoloadFilter类的核心逻辑是读取项目composer.json中extra里的only-modules或except-modules配置，修改Composer生成的自动加载文件，仅保留指定模块的类映射规则。这种方式完全可控，但需要额外开发过滤逻辑。

方案二：虚拟包+语义化依赖声明 #

把每个模块封装为“虚拟包”，在主包的composer.json中用provide字段声明这些虚拟包，项目端通过require虚拟包来明确指定要使用的模块。

示例配置：

{
  "name": "your/measurement-package",
  "autoload": {
    "psr-4": {
      "Your\\Measurement\\Core\\": "src/Core/",
      "Your\\Measurement\\Length\\": "src/Length/",
      "Your\\Measurement\\Power\\": "src/Power/"
    }
  },
  "provide": {
    "your/measurement-length": "self.version",
    "your/measurement-power": "self.version"
  },
  "suggest": {
    "your/measurement-length": "添加长度单位支持",
    "your/measurement-power": "添加功率单位支持"
  }
}

项目端仅需Length模块时，只需在composer.json中声明：

{
  "require": {
    "your/measurement-package": "^1.0",
    "your/measurement-length": "^1.0"
  }
}

这种方式无需额外脚本，利用Composer自动加载机制：只要项目不引用某模块的类，该模块的文件就不会被加载到内存。虽然磁盘上仍保留所有模块文件，但你的包总大小仅6MB，这种冗余完全可接受，还避免了拆分包的磁盘浪费问题。

2. 多依赖场景下的加载冲突处理 #

针对项目A要求加载Length、依赖的项目B要求加载Power的场景，按以下方式处理：

• 模块解耦：将核心类（如MeasurementUnitValueObject接口）放在独立的Core模块，所有业务模块仅依赖Core，模块之间无交叉依赖，从根源避免冲突。
• 合并加载规则：若使用方案一的过滤脚本，脚本需采用合并逻辑：只要有一个依赖要求加载某模块，就保留该模块的加载规则，最终同时加载Length和Power模块。
• 虚拟包自动合并：若使用方案二，Composer会自动合并所有依赖的虚拟包，主包会同时提供这些虚拟包的支持，且模块间通过命名空间严格隔离（如Your\Measurement\Length\Length、Your\Measurement\Power\Power），不会出现命名冲突。

补充建议 #

考虑到你的包总大小仅6MB，方案二是最优选择：既满足项目按需声明模块的需求，又无需复杂开发，同时避免了拆分独立包带来的磁盘空间浪费。只要模块间严格解耦、命名空间清晰，多依赖场景下也不会出现冲突。

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