provide声明“我实现某抽象包”，如兼容psr/log接口；replace声明“我替代某具体包”，如fork后接管oldvendor/package；二者可组合实现虚拟包提供+旧包接管，但语义不同、用途各异。
provide 字段用于声明“我实现了某个抽象包”
当你的包不叫 psr/log，但完全兼容其接口并提供了完整实现（比如你写了另一个日志门面），就可以用 provide 告诉 Composer：“我虽不是官方包，但能当 psr/log 用”。Composer 安装时会把它当作该抽象包的可用实现之一。
常见错误是写错版本号 —— provide 的值**不是你自己的版本**，而是你所声明实现的那个包的版本约束。例如：
{
"name": "mycompany/custom-log-adapter",
"provide": {
"psr/log": "^1.0 || ^2.0 || ^3.0"
}
}
注意：provide 不会自动安装你的包；它只在别人 require psr/log 且没指定具体实现时，让 Composer 知道“这个包可选”。真正生效还需配合 conflict 或用户显式 require 你。
- 仅对
require阶段起作用，不影响自动加载 - 不能用于替换已安装的包，只是“提供能力”的声明
- 多个包
provide同一抽象包时，Composer 会按依赖图选择一个（无优先级）
replace 字段用于“我替代某个包，它不该再被装”
replace 是更激进的操作：它告诉 Composer，“如果项目或依赖里写了要装 monolog/monolog，别装它了，用我代替”。这常用于 fork 维护、内部重命名或清理废弃包。
典型场景：你把 oldvendor/package fork 成 newvendor/package，并希望所有依赖它的项目无缝切换：
{
"name": "newvendor/package",
"replace": {
"oldvendor/package": "*"
}
}
关键点：
-
replace会阻止被替换包的安装，即使其他依赖明确require它 - 被替换的包不会进入
vendor/，也不会触发其autoload或脚本 - 若多个包
replace同一个名字，Composer 报错（冲突），必须手动 resolve - 慎用
"*"—— 若被替换包有特定版本逻辑（如^2.0），建议写成"^2.0 || ^3.0"更安全
provide + replace 组合解决“虚拟包 + 实现接管”问题
当你想既提供抽象能力（如 psr/container），又彻底接管旧实现（如 container-interop/container-interop），就需要两者并用。
例如一个现代容器封装包：
{
"name": "myorg/modern-container",
"provide": {
"psr/container": "^1.0 || ^2.0"
},
"replace": {
"container-interop/container-interop": "*",
"php-di/invoker": "^2.0"
}
}
这样做的效果是：
- 任何 require
psr/container的包，都可能选中你（只要没锁死其他实现） -
container-interop/container-interop和php-di/invoker永远不会出现在vendor/中 - 你的包会被安装，且其
autoload生效，其他包可通过psr/container接口调用你
容易踩的坑：如果被 replace 的包本身又被其他依赖通过 require-dev 引入，Composer 可能报循环或冲突 —— 此时需检查 composer show -t 输出，确认替换路径是否干净。
真实项目中哪些地方最容易误用
多数误用来自混淆语义：provide 是“我能干这事”，replace 是“这事只能由我干”。它们不互斥，但目标完全不同。
典型翻车点：
- 在私有 SDK 包里写
"provide": {"laravel/framework": "^10.0"}—— 这毫无意义，因为你不可能真正实现整个 Laravel - 用
replace替换ext-*扩展（如"ext-curl": "*"）—— Composer 不识别扩展名作为包名，会静默忽略 - 在根
composer.json里写provide—— 它只在 package（即发布到 packagist 或私仓的库）中生效 - 以为
replace会自动重映射命名空间 —— 它只影响安装行为，autoload 还得靠你自己的autoload配置
最常被忽略的是：Composer 7+ 对 provide 的解析更严格，若你声明提供 psr/http-message，但实际未包含对应接口类，运行时仍会报 Class not found —— provide 不校验代码，只管依赖图。
