尧图网页设计 
psr/log API参考手册8个核心组件逐一精讲PHP日志开发必备速查表【免费下载链接】log项目地址: https://gitcode.com/gh_mirrors/lo/logpsr/log 是 PHP 生态中最基础的日志接口库它实现了 PSR-3 标准提供了一套统一的 PHP 日志接口——本身不输出任何日志却定义了所有日志库必须遵守的规范。无论你是写业务代码还是开发自己的日志库读懂它的 8 个核心组件就是读懂整个 PHP 日志世界的普通话。本文带你逐一精讲并附一张可直接收藏的速查表 一、30秒了解 psr/log它是什么、怎么用一句话概括psr/log 不是日志库而是日志库的插座标准。就像家里电器用的都是同一种插座Monolog、Syslog 等日志实现都实现了同一套接口你写的业务代码可以随意切换它们一行代码都不用改 通过 Composer 一键安装即可使用composer require psr/log在 composer.json 中可以看到当前版本3.x要求 PHP 8.0.0采用 PSR-4 自动加载Psr\Log\命名空间。二、8个核心组件速查表先上总表方便你按需跳转阅读 #组件文件一句话作用1LoggerInterfacesrc/LoggerInterface.php定义 9 个标准日志方法2LogLevelsrc/LogLevel.php8 个日志级别常量3LoggerTraitsrc/LoggerTrait.php帮你自动实现 8 个级别方法4AbstractLoggersrc/AbstractLogger.php自定义日志库的基类5NullLoggersrc/NullLogger.php什么都不记录的黑洞日志器6LoggerAwareInterfacesrc/LoggerAwareInterface.php统一声明 setLogger 注入入口7LoggerAwareTraitsrc/LoggerAwareTrait.php一行实现日志注入8InvalidArgumentExceptionsrc/InvalidArgumentException.php日志参数非法时抛出的异常三、核心组件逐一精讲1️⃣ LoggerInterface一切日志的契约这是整个 psr/log 的灵魂。任何日志库只要实现了它就能和你的代码对接。它定义了 9 个方法8 个按级别命名的便捷方法emergency到debug 1 个通用方法log($level, $message, $context)。两条关键规则写在 LoggerInterface.php 的注释里消息必须是字符串或实现了__toString()的对象可以带{foo}占位符由上下文数据自动替换上下文数组里如果携带异常对象必须放在exception这个键下实现方才能据此打印堆栈。2️⃣ LogLevel8个级别的常量字典LogLevel.php 只有一组常量但它定义了业界通用的 8 级日志体系严重度从高到低emergency → alert → critical → error warning → notice → info → debug记忆口诀急警危错警提信调——从系统瘫了打电话叫醒你emergency一路到开发调试信息debug。使用常量而非魔法字符串可以避免拼写错误。3️⃣ LoggerTrait8个方法一个 trait 全搞定自己实现接口时最烦的就是写 8 个几乎一样的级别方法。LoggerTrait.php 把这 8 个方法都代理给了log()你只需真正实现 1 个方法abstract public function log($level, string|\Stringable $message, array $context []): void;也就是说接入 PSR-3 的实现成本从写 9 个方法降到了写 1 个方法 ✂️4️⃣ AbstractLogger自定义日志器的基类AbstractLogger.php 非常精简——它实现 LoggerInterface并use LoggerTrait。当你开发自己的日志库时直接继承它就自动拥有了全部 8 个级别方法这是面向继承的接入方式。5️⃣ NullLogger优雅地说这次不记日志NullLogger.php 的log()方法体是空的——所有日志调用都石沉大海。它的价值在于避免代码里散落if ($this-logger)的判断。当用户没有配置日志器时传入一个NullLogger实例代码保持简洁还符合日志应当始终是可选的这一设计哲学。6️⃣ LoggerAwareInterface声明我能接受日志器LoggerAwareInterface.php 只有一个方法setLogger(LoggerInterface $logger)。如果你的类知道并使用日志器实现它就能向容器或调用方声明我可以被注入一个日志器。这是依赖注入思想在日志场景的标准表达 7️⃣ LoggerAwareTrait注入日志的一行实现LoggerAwareTrait.php 提供了接口的基础实现一个可空的$logger属性 一个setLogger()方法。类里use LoggerAwareTrait并实现LoggerAwareInterface注入能力即刻拥有。它与 LoggerTrait 是姊妹关系一个负责接收日志器一个负责实现日志行为。8️⃣ InvalidArgumentException参数非法的标准报错InvalidArgumentException.php 继承自 PHP 内置异常不增加任何行为只为给日志场景一个专属异常身份当log()收到非法的日志级别时抛出它调用方可以精确捕获而不是一股脑捕获所有参数异常。四、怎么选场景化速查表你的场景该用什么写业务代码只需打日志依赖 LoggerInterface 即可自定义日志级别判断引用 LogLevel 常量开发日志库走继承路线继承 AbstractLogger开发日志库已被其他类占用继承位引入 LoggerTrait日志器可能不存在兜底用 NullLogger给类提供日志注入入口LoggerAwareInterface LoggerAwareTrait五、总结psr/log 用 8 个轻量组件构建起了 PHP 日志开发的通用语言LoggerInterface定契约LogLevel定级别LoggerTrait / AbstractLogger降低实现成本NullLogger让无日志同样优雅LoggerAware 接口与 Trait打通依赖注入InvalidArgumentException规范错误边界。记住这套速查表再复杂的日志框架对你来说也不过是同一套接口的新实现。下次选型时先看它是否支持 PSR-3基本就不会踩坑 ✅【免费下载链接】log项目地址: https://gitcode.com/gh_mirrors/lo/log创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 psr/log API参考手册：8个核心组件逐一精讲，PHP日志开发必备速查表
psr/log API参考手册8个核心组件逐一精讲PHP日志开发必备速查表【免费下载链接】log项目地址: https://gitcode.com/gh_mirrors/lo/logpsr/log 是 PHP 生态中最基础的日志接口库它实现了 PSR-3 标准提供了一套统一的 PHP 日志接口——本身不输出任何日志却定义了所有日志库必须遵守的规范。无论你是写业务代码还是开发自己的日志库读懂它的 8 个核心组件就是读懂整个 PHP 日志世界的普通话。本文带你逐一精讲并附一张可直接收藏的速查表 一、30秒了解 psr/log它是什么、怎么用一句话概括psr/log 不是日志库而是日志库的插座标准。就像家里电器用的都是同一种插座Monolog、Syslog 等日志实现都实现了同一套接口你写的业务代码可以随意切换它们一行代码都不用改 通过 Composer 一键安装即可使用composer require psr/log在 composer.json 中可以看到当前版本3.x要求 PHP 8.0.0采用 PSR-4 自动加载Psr\Log\命名空间。二、8个核心组件速查表先上总表方便你按需跳转阅读 #组件文件一句话作用1LoggerInterfacesrc/LoggerInterface.php定义 9 个标准日志方法2LogLevelsrc/LogLevel.php8 个日志级别常量3LoggerTraitsrc/LoggerTrait.php帮你自动实现 8 个级别方法4AbstractLoggersrc/AbstractLogger.php自定义日志库的基类5NullLoggersrc/NullLogger.php什么都不记录的黑洞日志器6LoggerAwareInterfacesrc/LoggerAwareInterface.php统一声明 setLogger 注入入口7LoggerAwareTraitsrc/LoggerAwareTrait.php一行实现日志注入8InvalidArgumentExceptionsrc/InvalidArgumentException.php日志参数非法时抛出的异常三、核心组件逐一精讲1️⃣ LoggerInterface一切日志的契约这是整个 psr/log 的灵魂。任何日志库只要实现了它就能和你的代码对接。它定义了 9 个方法8 个按级别命名的便捷方法emergency到debug 1 个通用方法log($level, $message, $context)。两条关键规则写在 LoggerInterface.php 的注释里消息必须是字符串或实现了__toString()的对象可以带{foo}占位符由上下文数据自动替换上下文数组里如果携带异常对象必须放在exception这个键下实现方才能据此打印堆栈。2️⃣ LogLevel8个级别的常量字典LogLevel.php 只有一组常量但它定义了业界通用的 8 级日志体系严重度从高到低emergency → alert → critical → error warning → notice → info → debug记忆口诀急警危错警提信调——从系统瘫了打电话叫醒你emergency一路到开发调试信息debug。使用常量而非魔法字符串可以避免拼写错误。3️⃣ LoggerTrait8个方法一个 trait 全搞定自己实现接口时最烦的就是写 8 个几乎一样的级别方法。LoggerTrait.php 把这 8 个方法都代理给了log()你只需真正实现 1 个方法abstract public function log($level, string|\Stringable $message, array $context []): void;也就是说接入 PSR-3 的实现成本从写 9 个方法降到了写 1 个方法 ✂️4️⃣ AbstractLogger自定义日志器的基类AbstractLogger.php 非常精简——它实现 LoggerInterface并use LoggerTrait。当你开发自己的日志库时直接继承它就自动拥有了全部 8 个级别方法这是面向继承的接入方式。5️⃣ NullLogger优雅地说这次不记日志NullLogger.php 的log()方法体是空的——所有日志调用都石沉大海。它的价值在于避免代码里散落if ($this-logger)的判断。当用户没有配置日志器时传入一个NullLogger实例代码保持简洁还符合日志应当始终是可选的这一设计哲学。6️⃣ LoggerAwareInterface声明我能接受日志器LoggerAwareInterface.php 只有一个方法setLogger(LoggerInterface $logger)。如果你的类知道并使用日志器实现它就能向容器或调用方声明我可以被注入一个日志器。这是依赖注入思想在日志场景的标准表达 7️⃣ LoggerAwareTrait注入日志的一行实现LoggerAwareTrait.php 提供了接口的基础实现一个可空的$logger属性 一个setLogger()方法。类里use LoggerAwareTrait并实现LoggerAwareInterface注入能力即刻拥有。它与 LoggerTrait 是姊妹关系一个负责接收日志器一个负责实现日志行为。8️⃣ InvalidArgumentException参数非法的标准报错InvalidArgumentException.php 继承自 PHP 内置异常不增加任何行为只为给日志场景一个专属异常身份当log()收到非法的日志级别时抛出它调用方可以精确捕获而不是一股脑捕获所有参数异常。四、怎么选场景化速查表你的场景该用什么写业务代码只需打日志依赖 LoggerInterface 即可自定义日志级别判断引用 LogLevel 常量开发日志库走继承路线继承 AbstractLogger开发日志库已被其他类占用继承位引入 LoggerTrait日志器可能不存在兜底用 NullLogger给类提供日志注入入口LoggerAwareInterface LoggerAwareTrait五、总结psr/log 用 8 个轻量组件构建起了 PHP 日志开发的通用语言LoggerInterface定契约LogLevel定级别LoggerTrait / AbstractLogger降低实现成本NullLogger让无日志同样优雅LoggerAware 接口与 Trait打通依赖注入InvalidArgumentException规范错误边界。记住这套速查表再复杂的日志框架对你来说也不过是同一套接口的新实现。下次选型时先看它是否支持 PSR-3基本就不会踩坑 ✅【免费下载链接】log项目地址: https://gitcode.com/gh_mirrors/lo/log创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考