provide 字段用于声明当前包提供虚拟包能力,影响依赖解析但不安装代码;虚拟包是无真实发布的接口契约,如 psr/log-implementation,真实包通过 provide 声明实现以满足依赖。

在 Composer 中,provide 字段用于声明当前包“提供”了某个虚拟包(virtual package)的能力,常用于替代、兼容或抽象真实依赖。它不安装任何代码,只影响依赖解析逻辑,是高级依赖管理的关键机制。
什么是虚拟包与 provide 的作用
虚拟包(如 psr/log-implementation、php-http/async-client-implementation)本身没有真实发布,只是命名约定的接口契约。Composer 通过 provide 让一个真实包(比如 monolog/monolog)声明自己实现了该契约,从而让其他依赖该虚拟包的项目能顺利安装——只要存在至少一个提供者即可满足依赖。
在 composer.json 中正确配置 provide
在根项目的 composer.json 或你正在开发的库中,将 provide 写在顶层字段下,值为对象,键是虚拟包名,值是版本号(通常用 * 表示兼容任意版本):
{
"name": "myorg/my-logger",
"version": "1.0.0",
"provide": {
"psr/log-implementation": "*",
"myorg/logger-interface": "1.0.0"
}
}
注意:
• 键必须是合法的包名格式(字母、数字、连字符、下划线、点),不能含空格或特殊符号
• 值可以是具体版本(如 "1.2.3")、约束(如 "^1.0")或通配符 "*"(推荐用于虚拟包)
• provide 不会自动加载类或复制文件,它纯粹是元数据声明
常见使用场景与注意事项
替代已有实现:当你写了一个轻量日志器,想替代 Monolog 被其他包识别为 psr/log-implementation,就需提供该虚拟包。
定义私有契约:团队内可约定 acme/cache-driver 作为缓存驱动抽象,各实现库(Redis、File、APCu)各自 provide 它。
避免冲突:若两个包都提供同一虚拟包但版本不兼容(如一个标 "^1.0",另一个标 "^2.0"),Composer 会报错,需统一语义版本策略。
不解决自动发现:提供虚拟包 ≠ 自动注册服务。你还得在代码中手动绑定实现(如 PSR-4 加载 + DI 容器配置)。
验证 provide 是否生效
运行以下命令检查当前项目中哪些包提供了指定虚拟包:
composer show --provides 'psr/log-implementation'
或查看锁文件 composer.lock 中的 packages 列表,搜索目标虚拟包名;也可执行 composer depends psr/log-implementation 查看谁依赖它。










