Composer虚拟包怎么配置依赖提供属性-composer-PHP中文网

虚拟包是Composer中用于声明“本项目提供某能力”的占位符机制，不对应真实包，通过composer.json根级provide字段定义（如"psr/cache-implementation": "*"），供其他包在require中松耦合依赖，但不解决运行时兼容性或自动加载。

composer虚拟包怎么配置依赖提供属性

什么是虚拟包（virtual package）及其作用

虚拟包不是真实发布的 Composer 包，它不对应任何 Git 仓库或 Packagist 上的实际包名，而是一种“占位符”机制，用于声明“本项目提供了某个能力”，让其他依赖它的包能通过 require 声明该能力而不必硬绑定具体实现。典型场景是框架抽象层（如 psr/log）或可插拔组件（如 cache-implementation）。

`provide` 字段必须写在 `composer.json` 的根层级

想让当前项目被识别为某个虚拟包的提供者，必须在自己的 composer.json 中显式声明 provide 字段，且不能嵌套在 require 或其他字段下。

provide 是一个对象，键为虚拟包名（如 "psr/log-implementation"），值为版本号（通常用 "*" 或具体语义版本，如 "3.0.0"）
错误写法："require": { "psr/log-implementation": "*" } —— 这是在请求别人提供，不是声明自己提供
正确写法示例：
```
{
  "name": "myorg/my-cache-driver",
  "type": "library",
  "provide": {
    "psr/cache-implementation": "*",
    "cache-implementation": "1.0.0"
  }
}
```
注意：虚拟包名无需真实存在 Packagist，只要其他包在 require 中写这个字符串，Composer 就会认为已满足依赖

依赖方如何利用虚拟包做松耦合约束

当另一个包（比如日志门面库）希望支持任意日志实现，又不想强制依赖 Monolog 或 PsrLogBridge，就可以在自己的 composer.json 中这样写：

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

在 require 中声明虚拟包："psr/log-implementation": "^1.0 || ^2.0"
不指定具体实现，只靠安装时环境里哪个包提供了该虚拟名来满足依赖
如果项目中同时装了 monolog/monolog（它在自身 composer.json 中 provide 了 "psr/log-implementation": "*"）和你写的 myorg/my-logger，Composer 会选择其一（按解析顺序，无确定性）——此时需靠运行时配置或接口契约保证兼容性

容易踩的坑：provide 不解决运行时兼容性，也不触发自动加载

provide 只影响 Composer 的依赖解析阶段，它不会：

自动把提供者的类映射进 vendor/autoload.php —— 你仍需在自己包的 composer.json 中配好 autoload（如 "psr-4"）
校验所提供接口是否真正实现（比如声明提供 psr/cache-implementation，但没实现 Psr\Cache\CacheInterface，Composer 不报错）
阻止多个包同时提供同一虚拟名 —— 这会导致依赖解析成功但运行时报错（Class not found / Method not implemented）
替代 conflict 或 replace：若想完全替代某个包（如用自研路由替换 symfony/routing），应使用 replace，而非 provide