psr/log 是 PHP-FIG 制定的 PSR-3 规范的契约式虚拟包,仅含 LoggerInterface 和异常类,无具体实现;它不提供日志功能,而是通过 Composer 依赖声明实现接口统一与运行时兼容。

psr/log 是 Composer 生态里最典型的“虚拟包”——它不提供任何可执行逻辑,只定义 LoggerInterface 和几个异常类。你装它,不是为了用它的代码,而是为了让依赖关系可声明、可校验、可替换。
直接回答核心问题:Composer 本身不“统一”接口,它只是靠 psr/log 这个包把 PHP-FIG 制定的 PSR-3 规范落地为一个可安装、可约束的依赖项。真正的统一发生在运行时:只要两个库都声明了 "psr/log": "^3.0",又都实现 LoggerInterface,它们就能互相传日志对象,不用改一行业务代码。
为什么装 psr/log 不会生成实际日志功能
这个包只有 interface 和 exception 类,没有 __construct()、没有具体实现、不能 new LoggerInterface()。它本质是一份“契约文档”的 PHP 翻译版。
- 你
composer require psr/log后,vendor/psr/log/src/下只有LoggerInterface.php和几个空异常类 - 如果你只装了
psr/log,调用$logger->error('msg')会报Fatal error: Interface 'Psr\Log\LoggerInterface' not implemented - 真正干活的是 Monolog、Laravel Log、或你自己写的实现——它们必须
implements LoggerInterface
psr/log 在 composer.json 中怎么写才有效
关键不是“装没装”,而是“怎么声明依赖”。很多初学者误以为只要自己项目 require 了 psr/log 就万事大吉,其实更常见也更重要的是在库的 composer.json 里正确约束。
- 作为库作者:在
require或require-dev里写"psr/log": "^3.0",表示“我接受任何符合 PSR-3 的日志器” - 作为应用开发者:不要在
require里硬写psr/log,除非你要手动实现接口;通常你require monolog/monolog,它会自动拉取psr/log并声明provides - 检查是否生效:
composer show psr/log应该显示已安装;composer why psr/log能看到谁依赖了它(比如monolog/monolog或guzzlehttp/guzzle)
容易踩的坑:版本错位和实现缺失
PSR-3 目前只有 v1 和 v2(v1 是原始版,v2 是带返回类型声明的 PHP 7.4+ 版),但 Composer 包名始终是 psr/log,版本号却可能指向不同语义版本。这会导致运行时行为不一致。
-
"psr/log": "^1.0"→ 接口方法无返回类型声明,PHP 7.0+ 兼容 -
"psr/log": "^2.0"→ 所有方法加了: void,要求 PHP 7.4+ - 如果 A 库要求
^1.0,B 库要求^2.0,Composer 可能无法满足,报conflict—— 此时必须统一升级或降级 - 更隐蔽的坑:你写了
class MyLogger implements Psr\Log\LoggerInterface,但漏实现了log()方法(它是可选的通用入口),而某个框架恰好调用了它,就会Fatal error
真正难的不是装包,而是确保所有参与方对同一份接口有完全一致的理解和实现覆盖。哪怕只少一个 notice() 方法,或者上下文数组里没按规范放 "exception" 键,跨库传递日志时就可能静默失败或格式错乱。


















