Composer 的 provide 和 replace 字段用于解决依赖冲突与抽象解耦：provide 声明本包实现某能力（如 PSR 接口），支持多实现共存；replace 声明本包替代某真实包（如 fork 替换），强制排他安装。

Composer 的 provide 和 replace 字段用于声明包与包之间的逻辑关系，核心作用是解决依赖冲突、实现接口抽象、支持多实现切换，以及构建“虚拟包”（virtual packages）——它们不对应真实代码，只作为依赖契约存在。

provide：声明“我实现了某个抽象能力”

provide 是一个映射字段，用来告诉 Composer：“本包提供了某类功能的实现”，即使它没有直接 require 那个包。常用于定义接口兼容的实现包。

• 典型场景是 PSR 标准或自定义接口的多实现。例如：
  

  "provide": {
        "psr/log-implementation": "1.0.0"
      }

  
  表示该包实现了 PSR-3 日志接口，其他依赖 psr/log-implementation 的包（如 Monolog、Psr\Log\LoggerInterface 的消费者）就能正常安装，无需硬绑定具体实现。
• 提供虚拟包名时，版本号可写 *（表示任意兼容版本），也可写具体约束（如 ^1.0 || ^2.0），Composer 会据此做依赖解析。
• 注意：provide 不会自动加载代码，也不影响自动加载配置（autoload），它只参与依赖图计算。

replace：声明“我替代了另一个包”

replace 用于明确告知 Composer：“安装我，就等价于安装了被替换的包”，Composer 将阻止被替换包的安装，避免冲突。

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

• 最常见用途是 fork 替换官方包。比如你维护一个修复版的 guzzlehttp/guzzle，可在 composer.json 中写：
  

  "replace": {
        "guzzlehttp/guzzle": ">=6.0.0"
      }

  
  这样当项目 require guzzlehttp/guzzle 时，Composer 会优先选你的包，并跳过安装原版。
• 可用于合并多个小包为一个聚合包。例如：myorg/all-components 通过 replace 声明它替换了 myorg/db、myorg/cache 等，下游项目只需 require 聚合包，即可获得全部功能且避免重复安装。
• ⚠️ 替换后，被 replace 的包不会被加载，其 autoload、scripts、extra 等元信息也失效——所以替换包必须自行提供等效能力。

虚拟包（Virtual Package）：用 provide 构建契约层

虚拟包本身不包含源码，仅靠 provide 声明能力，是解耦“需求”和“实现”的关键设计模式。

• 例如定义一个虚拟包 acme/cache-driver，没有任何实际代码，只在 composer.json 中写：
  

  "name": "acme/cache-driver",
  "provide": {
    "acme/cache-driver": "*"
  }

  
  其他缓存实现（Redis、Memcached、FileCache）都 provide: {"acme/cache-driver": "*"}，主应用只需 require: "acme/cache-driver"，就能自由切换底层驱动。
• 虚拟包可配合 conflict 使用，防止多个实现同时安装（如 "conflict": {"acme/cache-driver": "=2.0"} 在具体实现中限制只能有一个生效）。
• Packagist 不允许提交纯虚拟包（无 source），但可托管在私有仓库或使用 package 类型仓库手动注册。

provide vs replace 的关键区别

二者都影响依赖解析，但语义和用途截然不同：

• provide 是“我具备某种能力”，强调兼容性与可选实现；不阻止其他提供者共存（除非另有 conflict）。
• replace 是“我就是那个东西”，强调排他性与替代关系；一旦启用，被替换包绝不会出现在最终依赖树中。
• 一个包可以同时 provide 多个虚拟能力，也可以 replace 多个真实包，但应避免循环替换或过度提供导致解析失败。