如何在 composer.json 中使用 provide 字段来声明一个虚拟包的实现？

"provide"字段用于声明当前包实现了某个虚拟包（如psr/log-implementation），使依赖该虚拟包的项目能识别并兼容安装；其值通常为"*"，键须为Packagist注册的虚拟包名。

在 composer.json 中使用 "provide" 字段，是为了声明当前包“提供”了某个虚拟包（virtual package）的实现，让其他依赖该虚拟包的项目能顺利安装，而无需实际安装那个抽象包本身。

什么是虚拟包和 provide 的作用

虚拟包（如 psr/log、php-http/async-client-implementation）不是真实可安装的包，而是由 Packagist 官方维护的一类接口契约或规范别名。它们本身没有源码，只用于表达“谁实现了这个标准”。"provide" 就是告诉 Composer：“我这个包，实现了 XXX 接口/规范”，从而满足其他包对 XXX 的 require 声明。

基本写法：在 require 或 replace 场景下声明 provide

"provide" 是 composer.json 根对象下的一个字段，值为关联数组，键是虚拟包名，值是版本号（通常用 * 表示兼容任意符合规范的版本）：

{
    "name": "myvendor/my-logger",
    "require": {
        "psr/log": "^1.0 || ^2.0 || ^3.0"
    },
    "provide": {
        "psr/log-implementation": "*"
    }
}

注意：
- 键名必须是 Packagist 上已注册的虚拟包名（如 psr/log-implementation），不能随意拼写；
- 值写 "*" 最常用，表示“本包完全实现了该规范”，Composer 会按语义化版本规则匹配依赖方的要求；
- 不需要同时在 require 里再写 "psr/log-implementation" —— 它不是真实包，不能被安装。

常见使用场景举例

以下情况常需加 provide：

标签： php laravel js json composer curl ai