provide 字段用于声明当前包提供了某接口的实现或功能替代,如 “psr/log-implementation”: “1.0” 表示已实现 PSR 日志接口,避免重复安装同类包;与 replace(替换包)和 conflict(冲突声明)不同,provide 强调功能等价性,适用于标准接口场景,提升依赖管理灵活性。
在 composer.json 中,provide 字段用于声明当前包“提供”了某个功能或接口的实现,通常用来表明它替代或兼容另一个包。它的主要作用是解决依赖冲突或避免重复安装功能相似的包。
声明功能替代或虚拟实现
有些库实现了某个标准接口或提供了与另一个包相同的功能。通过 provide,你可以告诉 composer:本包已经包含了某个接口的实现,其他依赖该接口的包无需再安装别的实现。
例如,PSR 日志接口的实现:
{ "provide": { "psr/log-implementation": "1.0" } }
这表示当前包提供了 psr/log 接口的一个具体实现。这样,其他依赖 psr/log-implementation 的包就知道已有实现存在,不会报错提示缺少实现。
防止重复安装同类包
某些情况下,多个包可能提供相同的功能(如不同的缓存适配器)。使用 provide 可以让 Composer 知道它们是互斥的。
比如你开发了一个日志库,它完全兼容 monolog/monolog 的接口:
{ "provide": { "monolog/monolog": "1.0" } }
这样,如果其他包依赖 monolog/monolog,而你这个包被安装了,Composer 就认为依赖已被满足,避免重复安装 Monolog。
与 replace 和 conflict 的区别
- provide:说我能当某个东西用(功能上等价)
- replace:说我替换了某个包(通常是分包时用,避免重复加载)
- conflict:说我不能和某个包共存
这三个字段一起帮助 Composer 更智能地处理依赖关系。
基本上就这些。provide 不是让你随意写的,它适用于有明确接口标准或实现契约的场景,正确使用能让生态更灵活。