尧图网页设计 
后端【免费下载链接】YOURLS The standard, self hosted, powerful and customizable, URL shortener in PHP项目地址https://gitcode.com/gh_mirrors/yo/YOURLS点击查看免费下载导读PSR-3PSR Log是 PHP-FIG 组织制定的「日志记录器接口」规范它不提供任何具体的日志实现只定义了一套描述「日志记录器」的通用接口让任意 PHP 库都能与 Monolog、Log4php 等日志库无缝协作。本文以 includes/vendor/psr/log/README.md 为骨架先完整讲解 PSR-3 接口规范的定义、安装方式与使用模式再深入 YOURLS 仓库源码揭示这套规范在自托管短链接服务 YOURLS 中是如何被落地实现的——包括YOURLS\Database\Logger的具体实现、8 个日志级别的语义、{placeholder}占位符约定以及yourls_debug_log()与 SQL 查询日志的完整调用链。读完本文你既能掌握 PSR-3 的标准用法也能在 YOURLS 中启用调试模式并读懂其日志输出。一、PSR-3 是什么一个只描述「记录器」的接口规范includes/vendor/psr/log/README.md 开篇就强调了一个关键事实This is not a logger of its own. It is merely an interface that describes a logger.也就是说psr/log这个包本身不是日志器它只是描述「日志器长什么样」的接口。真正的日志写入写文件、发邮件、上报监控系统由你选择的实现来完成。这套规范的价值在于只要你的类依赖Psr\Log\LoggerInterface而不是某个具体日志库就能在运行时自由替换底层日志实现实现类与日志库的解耦。YOURLS 正是这样做的YOURLS 自身的调试日志器 includes/Database/Logger.php 继承了Psr\Log\AbstractLogger而数据库查询剖析器Profiler的日志则来自 Aura SQL 包基于\Aura\Sql\Profiler\MemoryLogger见 includes/Database/Logger.php 的注释。两者通过同一套 PSR-3 接口被统一消费。二、安装用 Composer 引入 psr/log规范文档给出的安装方式只有一条命令composer require psr/log在 YOURLS 仓库中该包已被安装并固化在 vendor 目录下包含以下 8 个源文件见 includes/vendor/psr/log/src文件职责LoggerInterface.php核心接口定义 9 个日志方法LogLevel.php定义 8 个日志级别常量AbstractLogger.php抽象基类把级别方法委托给log()LoggerTrait.php与 AbstractLogger 等价的 Trait供无法继承基类的类使用LoggerAwareInterface.php描述「可感知日志器」的对象接口LoggerAwareTrait.phpLoggerAwareInterface的基础实现NullLogger.php空实现丢弃所有日志InvalidArgumentException.php无效日志级别时抛出的异常类在 YOURLS 根目录的 composer.json 中psr/log位于require依赖之列通过 includes/vendor/autoload.php 注册到 PSR-4 自动加载映射详见 includes/vendor/composer/autoload_psr4.php。三、使用面向 LoggerInterface 编程README 给出了一个标准的「面向接口」使用示例构造函数注入一个可选的LoggerInterface在业务方法里按需记录信息或错误?php use Psr\Log\LoggerInterface; class Foo { private $logger; public function __construct(LoggerInterface $logger null) { $this-logger $logger; } public function doSomething() { if ($this-logger) { $this-logger-info(Doing work); } try { $this-doSomethingElse(); } catch (Exception $exception) { $this-logger-error(Oh no!, array(exception $exception)); } // do something useful } }这个例子体现了三个最佳实践可选注入$logger允许为null调用前用if ($this-logger)判空避免强依赖异常入上下文捕获异常时把异常对象放进$context[exception]键这是规范里唯一对上下文键名做的约定无需关心实现Foo类完全不知道底层是文件日志、还是内存日志。3.1 如何获得一个可用的 Logger「You can then pick one of the implementations of the interface to get a logger.」——你只需挑选任意一个实现了LoggerInterface的日志库如 Monolog就能把这个Foo类接上真实日志。若暂时没有实现可用规范还提供了Psr\Log\NullLogger它是一个log()方法体为// noop空操作的实现见 NullLogger.php。文档建议用它来消灭if ($this-logger) { }条件块——给对象注入一个 NullLogger 后就可以直接调用$logger-info(...)而无需判空日志会被静默丢弃行为与不记录完全一致。四、LoggerInterface 与 8 个日志级别LoggerInterface.php 定义了 9 个方法8 个级别方法加上 1 个通用方法log($level, $message, $context)。每个级别方法签名统一为方法名(string|\Stringable $message, array $context []): void。级别的语义依据 LoggerInterface.php 的注释与 LogLevel.php 的常量级别常量值语义与典型场景emergencyemergency系统不可用如整站宕机、数据库连不上应立即触发短信告警alertalert必须立刻采取行动如整个网站挂掉criticalcritical严重状态如应用组件不可用、未预期的异常errorerror运行时错误不必立即处理但应被记录与监控warningwarning非错误的异常情况如使用了废弃 API、API 使用不当noticenotice正常但重要的事件infoinfo有趣的事件如用户登录、SQL 日志debugdebug详细的调试信息4.1 消息与上下文的约定接口注释明确了两条约束消息类型$message必须是字符串或实现了__toString()的对象源码中类型声明为string|\Stringable占位符消息可包含{foo}形式的占位符运行时会被$context中键名为foo的值替换异常键$context可含任意数据但若要携带异常以生成堆栈追踪必须放在键名为exception的位置。4.2 无级别方法也能写日志log()log($level, $message, $context)允许以任意级别如LogLevel::WARNING动态记录当传入未定义级别时会抛出\Psr\Log\InvalidArgumentException见 InvalidArgumentException.php。所有级别方法只是它的「语法糖」。五、实现接口的两种姿势AbstractLogger 与 LoggerTraitREADME 指出如果你想自己实现一个日志器只需require本包并实现Psr\Log\LoggerInterface。规范为此提供了两条减少样板代码的捷径5.1 继承 AbstractLoggerAbstractLogger.php 是一个空壳抽象类它通过use LoggerTrait获得 8 个级别方法的默认实现——所有级别方法都被委托给唯一的抽象方法log()。因此你实现日志器时只需写一个log()方法级别分发逻辑全部免费class MyLogger extends AbstractLogger { public function log($level, string|\Stringable $message, array $context []): void { // 真正写日志的逻辑 } }5.2 使用 LoggerTraitLoggerTrait.php 与 AbstractLogger 逻辑完全一致每个方法如info()内部执行$this-log(LogLevel::INFO, $message, $context)但它是 Trait供已经继承其他类、无法再继承 AbstractLogger的类使用PHP 单继承限制下的替代方案。5.3 LoggerAware让对象「感知」日志器配套的 LoggerAwareInterface.php 与 LoggerAwareTrait.php 提供「注入日志器」的规范入口实现该接口的类拥有setLogger(LoggerInterface $logger): void方法Trait 内部用protected ?LoggerInterface $logger null保存实例方便依赖注入容器统一装配。六、纵深PSR-3 在 YOURLS 中的真实落地下面把镜头切到 YOURLS 仓库本身看看这套接口在实际项目里如何被消费。这正体现了 PSR-3「只定接口、实现自由」的设计意图。6.1 YOURLS 自己的 LoggerYOURLS\Database\Loggerincludes/Database/Logger.php 定义了class Logger extends AbstractLogger它是 YOURLS 的定制日志器自 1.7.10 版本起注释见文件头部。它只重写了一个log()方法核心逻辑分两条路径普通日志如debug级别直接把$message转为字符串存入$this-messages[]数组SQL 查询日志$level query对来自 Aura SQL Profiler 的上下文做格式化通过debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 6)回溯调用栈识别真正发起查询的方法名fetchAll、fetchOne等否则回退为perform最终生成形如SQL fetchAll: SELECT ... (%s s)的可读消息耗时用number_format($context[duration], 5)保留 5 位小数。它还提供两个公开方法getMessages()返回已收集的所有日志消息数组pretty_format($statement, $values)用正则/:([^\s;)]*)/把 PDO 命名占位符如:url替换为上下文中的实际值方便人眼阅读。注意注释明确警告这只是为了可读性的外观替换替换结果不是合法 SQL不会正确加引号。6.2 调用链yourls_debug_log() 如何驱动 Loggerincludes/functions-debug.php 是调试日志的对外入口yourls_debug_log(string $msg)第 17 行起当处于调试模式时执行yourls_get_db(read-debug_log)-getProfiler()-getLogger()-log(debug, $msg)yourls_get_db()返回的数据库对象在 includes/Database/YDB.php 中会new Logger()并挂到 Profiler 上——于是yourls_debug_log()的调用最终落到YOURLS\Database\Logger::log(debug, ...)。实际调用点遍布全库例如includes/class-mysql.phpyourls_debug_log( Connected to . $dsn )记录数据库连接includes/functions-auth.php密码哈希读写失败、Cookie 写入失败等认证环节的多个调试点includes/functions-http.php远程请求异常时yourls_debug_log( $e-getMessage() ... )。6.3 调试模式开关调试日志默认不工作需满足两个条件之一启动时配置常量YOURLS_DEBUG true见 includes/class-mysql.php 的yourls_debug_mode( YOURLS_DEBUG )运行期调用yourls_debug_mode(true)动态开启定义见 includes/functions-debug.php。启用后可通过yourls_get_db(read-get_debug_log)-getProfiler()-getLogger()-getMessages()includes/functions-debug.php读取已收集的消息数组结合 includes/Database/YDB.php 中 Profiler 对查询消息的聚合即可同时获得应用调试信息与 SQL 查询耗时日志。6.4 一个「接口解耦」的活例子在 YOURLS 中同一个Psr\Log\LoggerInterface名下并存了两类日志来源来源级别消息示例yourls_debug_log()debugConnected to mysql:host...Aura SQL Profiler 内部日志query{function} ({duration} seconds): {statement} {backtrace}原始格式经Logger::log()重排为SQL fetchAll: SELECT ... (0.00253 s)YOURLS\Database\Logger::log()通过判断$level区分两者见 includes/Database/Logger.php这正是 PSR-3 接口「统一方法入口、自由分发处理」的典型应用——日志框架只需认准log()一个方法。七、实战小结依赖注入composer require psr/log后你的类只依赖Psr\Log\LoggerInterface运行时注入 Monolog 等实现即可级别语义8 个级别从emergency到debug严重度递减$context中保留exception键用于异常堆栈实现捷径继承AbstractLogger或use LoggerTrait只需实现log()一个方法不想判空就用NullLoggerYOURLS 实践yourls_debug_log()→YDB::getProfiler()-getLogger()→YOURLS\Database\Logger::log()构成完整调用链配置YOURLS_DEBUG true即可让调试日志与 SQL 查询日志同时生效。相关源码入口psr/log 接口定义、YOURLS Logger 实现、调试函数、数据库与 Profiler 装配、composer 依赖声明。赞分享后端【免费下载链接】YOURLS The standard, self hosted, powerful and customizable, URL shortener in PHP项目地址https://gitcode.com/gh_mirrors/yo/YOURLS点击查看免费下载相关推荐Dolibarr 仓库中的 PSR-3 日志接口规范深入解析 Psr\Log 包的接口、实现与集成实践Dolibarr 仓库中的 PSR 3 日志接口规范深入解析 Psr\Log 包的接口、实现与集成实践 PSR 3PHP Standard Recommen企业应用后端Hutch完整指南如何快速构建高效的RabbitMQ消息处理系统Hutch完整指南如何快速构建高效的RabbitMQ消息处理系统 Hutch是一个基于Ruby的 高效RabbitMQ消息处理系统 框架专为构建可靠的消息驱消息队列后端微服务PSR-3 日志接口规范深度解析Psr\Log\LoggerInterface 的设计原理与实战实现PSR 3 日志接口规范深度解析Psr\Log\LoggerInterface 的设计原理与实战实现 PSR 3Logger Interface日志接口文档开发工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 YOURLS 中的 PSR-3 日志接口：从规范到 YOURLS 的 Logger 实现与调试实践
后端【免费下载链接】YOURLS The standard, self hosted, powerful and customizable, URL shortener in PHP项目地址https://gitcode.com/gh_mirrors/yo/YOURLS点击查看免费下载导读PSR-3PSR Log是 PHP-FIG 组织制定的「日志记录器接口」规范它不提供任何具体的日志实现只定义了一套描述「日志记录器」的通用接口让任意 PHP 库都能与 Monolog、Log4php 等日志库无缝协作。本文以 includes/vendor/psr/log/README.md 为骨架先完整讲解 PSR-3 接口规范的定义、安装方式与使用模式再深入 YOURLS 仓库源码揭示这套规范在自托管短链接服务 YOURLS 中是如何被落地实现的——包括YOURLS\Database\Logger的具体实现、8 个日志级别的语义、{placeholder}占位符约定以及yourls_debug_log()与 SQL 查询日志的完整调用链。读完本文你既能掌握 PSR-3 的标准用法也能在 YOURLS 中启用调试模式并读懂其日志输出。一、PSR-3 是什么一个只描述「记录器」的接口规范includes/vendor/psr/log/README.md 开篇就强调了一个关键事实This is not a logger of its own. It is merely an interface that describes a logger.也就是说psr/log这个包本身不是日志器它只是描述「日志器长什么样」的接口。真正的日志写入写文件、发邮件、上报监控系统由你选择的实现来完成。这套规范的价值在于只要你的类依赖Psr\Log\LoggerInterface而不是某个具体日志库就能在运行时自由替换底层日志实现实现类与日志库的解耦。YOURLS 正是这样做的YOURLS 自身的调试日志器 includes/Database/Logger.php 继承了Psr\Log\AbstractLogger而数据库查询剖析器Profiler的日志则来自 Aura SQL 包基于\Aura\Sql\Profiler\MemoryLogger见 includes/Database/Logger.php 的注释。两者通过同一套 PSR-3 接口被统一消费。二、安装用 Composer 引入 psr/log规范文档给出的安装方式只有一条命令composer require psr/log在 YOURLS 仓库中该包已被安装并固化在 vendor 目录下包含以下 8 个源文件见 includes/vendor/psr/log/src文件职责LoggerInterface.php核心接口定义 9 个日志方法LogLevel.php定义 8 个日志级别常量AbstractLogger.php抽象基类把级别方法委托给log()LoggerTrait.php与 AbstractLogger 等价的 Trait供无法继承基类的类使用LoggerAwareInterface.php描述「可感知日志器」的对象接口LoggerAwareTrait.phpLoggerAwareInterface的基础实现NullLogger.php空实现丢弃所有日志InvalidArgumentException.php无效日志级别时抛出的异常类在 YOURLS 根目录的 composer.json 中psr/log位于require依赖之列通过 includes/vendor/autoload.php 注册到 PSR-4 自动加载映射详见 includes/vendor/composer/autoload_psr4.php。三、使用面向 LoggerInterface 编程README 给出了一个标准的「面向接口」使用示例构造函数注入一个可选的LoggerInterface在业务方法里按需记录信息或错误?php use Psr\Log\LoggerInterface; class Foo { private $logger; public function __construct(LoggerInterface $logger null) { $this-logger $logger; } public function doSomething() { if ($this-logger) { $this-logger-info(Doing work); } try { $this-doSomethingElse(); } catch (Exception $exception) { $this-logger-error(Oh no!, array(exception $exception)); } // do something useful } }这个例子体现了三个最佳实践可选注入$logger允许为null调用前用if ($this-logger)判空避免强依赖异常入上下文捕获异常时把异常对象放进$context[exception]键这是规范里唯一对上下文键名做的约定无需关心实现Foo类完全不知道底层是文件日志、还是内存日志。3.1 如何获得一个可用的 Logger「You can then pick one of the implementations of the interface to get a logger.」——你只需挑选任意一个实现了LoggerInterface的日志库如 Monolog就能把这个Foo类接上真实日志。若暂时没有实现可用规范还提供了Psr\Log\NullLogger它是一个log()方法体为// noop空操作的实现见 NullLogger.php。文档建议用它来消灭if ($this-logger) { }条件块——给对象注入一个 NullLogger 后就可以直接调用$logger-info(...)而无需判空日志会被静默丢弃行为与不记录完全一致。四、LoggerInterface 与 8 个日志级别LoggerInterface.php 定义了 9 个方法8 个级别方法加上 1 个通用方法log($level, $message, $context)。每个级别方法签名统一为方法名(string|\Stringable $message, array $context []): void。级别的语义依据 LoggerInterface.php 的注释与 LogLevel.php 的常量级别常量值语义与典型场景emergencyemergency系统不可用如整站宕机、数据库连不上应立即触发短信告警alertalert必须立刻采取行动如整个网站挂掉criticalcritical严重状态如应用组件不可用、未预期的异常errorerror运行时错误不必立即处理但应被记录与监控warningwarning非错误的异常情况如使用了废弃 API、API 使用不当noticenotice正常但重要的事件infoinfo有趣的事件如用户登录、SQL 日志debugdebug详细的调试信息4.1 消息与上下文的约定接口注释明确了两条约束消息类型$message必须是字符串或实现了__toString()的对象源码中类型声明为string|\Stringable占位符消息可包含{foo}形式的占位符运行时会被$context中键名为foo的值替换异常键$context可含任意数据但若要携带异常以生成堆栈追踪必须放在键名为exception的位置。4.2 无级别方法也能写日志log()log($level, $message, $context)允许以任意级别如LogLevel::WARNING动态记录当传入未定义级别时会抛出\Psr\Log\InvalidArgumentException见 InvalidArgumentException.php。所有级别方法只是它的「语法糖」。五、实现接口的两种姿势AbstractLogger 与 LoggerTraitREADME 指出如果你想自己实现一个日志器只需require本包并实现Psr\Log\LoggerInterface。规范为此提供了两条减少样板代码的捷径5.1 继承 AbstractLoggerAbstractLogger.php 是一个空壳抽象类它通过use LoggerTrait获得 8 个级别方法的默认实现——所有级别方法都被委托给唯一的抽象方法log()。因此你实现日志器时只需写一个log()方法级别分发逻辑全部免费class MyLogger extends AbstractLogger { public function log($level, string|\Stringable $message, array $context []): void { // 真正写日志的逻辑 } }5.2 使用 LoggerTraitLoggerTrait.php 与 AbstractLogger 逻辑完全一致每个方法如info()内部执行$this-log(LogLevel::INFO, $message, $context)但它是 Trait供已经继承其他类、无法再继承 AbstractLogger的类使用PHP 单继承限制下的替代方案。5.3 LoggerAware让对象「感知」日志器配套的 LoggerAwareInterface.php 与 LoggerAwareTrait.php 提供「注入日志器」的规范入口实现该接口的类拥有setLogger(LoggerInterface $logger): void方法Trait 内部用protected ?LoggerInterface $logger null保存实例方便依赖注入容器统一装配。六、纵深PSR-3 在 YOURLS 中的真实落地下面把镜头切到 YOURLS 仓库本身看看这套接口在实际项目里如何被消费。这正体现了 PSR-3「只定接口、实现自由」的设计意图。6.1 YOURLS 自己的 LoggerYOURLS\Database\Loggerincludes/Database/Logger.php 定义了class Logger extends AbstractLogger它是 YOURLS 的定制日志器自 1.7.10 版本起注释见文件头部。它只重写了一个log()方法核心逻辑分两条路径普通日志如debug级别直接把$message转为字符串存入$this-messages[]数组SQL 查询日志$level query对来自 Aura SQL Profiler 的上下文做格式化通过debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 6)回溯调用栈识别真正发起查询的方法名fetchAll、fetchOne等否则回退为perform最终生成形如SQL fetchAll: SELECT ... (%s s)的可读消息耗时用number_format($context[duration], 5)保留 5 位小数。它还提供两个公开方法getMessages()返回已收集的所有日志消息数组pretty_format($statement, $values)用正则/:([^\s;)]*)/把 PDO 命名占位符如:url替换为上下文中的实际值方便人眼阅读。注意注释明确警告这只是为了可读性的外观替换替换结果不是合法 SQL不会正确加引号。6.2 调用链yourls_debug_log() 如何驱动 Loggerincludes/functions-debug.php 是调试日志的对外入口yourls_debug_log(string $msg)第 17 行起当处于调试模式时执行yourls_get_db(read-debug_log)-getProfiler()-getLogger()-log(debug, $msg)yourls_get_db()返回的数据库对象在 includes/Database/YDB.php 中会new Logger()并挂到 Profiler 上——于是yourls_debug_log()的调用最终落到YOURLS\Database\Logger::log(debug, ...)。实际调用点遍布全库例如includes/class-mysql.phpyourls_debug_log( Connected to . $dsn )记录数据库连接includes/functions-auth.php密码哈希读写失败、Cookie 写入失败等认证环节的多个调试点includes/functions-http.php远程请求异常时yourls_debug_log( $e-getMessage() ... )。6.3 调试模式开关调试日志默认不工作需满足两个条件之一启动时配置常量YOURLS_DEBUG true见 includes/class-mysql.php 的yourls_debug_mode( YOURLS_DEBUG )运行期调用yourls_debug_mode(true)动态开启定义见 includes/functions-debug.php。启用后可通过yourls_get_db(read-get_debug_log)-getProfiler()-getLogger()-getMessages()includes/functions-debug.php读取已收集的消息数组结合 includes/Database/YDB.php 中 Profiler 对查询消息的聚合即可同时获得应用调试信息与 SQL 查询耗时日志。6.4 一个「接口解耦」的活例子在 YOURLS 中同一个Psr\Log\LoggerInterface名下并存了两类日志来源来源级别消息示例yourls_debug_log()debugConnected to mysql:host...Aura SQL Profiler 内部日志query{function} ({duration} seconds): {statement} {backtrace}原始格式经Logger::log()重排为SQL fetchAll: SELECT ... (0.00253 s)YOURLS\Database\Logger::log()通过判断$level区分两者见 includes/Database/Logger.php这正是 PSR-3 接口「统一方法入口、自由分发处理」的典型应用——日志框架只需认准log()一个方法。七、实战小结依赖注入composer require psr/log后你的类只依赖Psr\Log\LoggerInterface运行时注入 Monolog 等实现即可级别语义8 个级别从emergency到debug严重度递减$context中保留exception键用于异常堆栈实现捷径继承AbstractLogger或use LoggerTrait只需实现log()一个方法不想判空就用NullLoggerYOURLS 实践yourls_debug_log()→YDB::getProfiler()-getLogger()→YOURLS\Database\Logger::log()构成完整调用链配置YOURLS_DEBUG true即可让调试日志与 SQL 查询日志同时生效。相关源码入口psr/log 接口定义、YOURLS Logger 实现、调试函数、数据库与 Profiler 装配、composer 依赖声明。赞分享后端【免费下载链接】YOURLS The standard, self hosted, powerful and customizable, URL shortener in PHP项目地址https://gitcode.com/gh_mirrors/yo/YOURLS点击查看免费下载相关推荐Dolibarr 仓库中的 PSR-3 日志接口规范深入解析 Psr\Log 包的接口、实现与集成实践Dolibarr 仓库中的 PSR 3 日志接口规范深入解析 Psr\Log 包的接口、实现与集成实践 PSR 3PHP Standard Recommen企业应用后端Hutch完整指南如何快速构建高效的RabbitMQ消息处理系统Hutch完整指南如何快速构建高效的RabbitMQ消息处理系统 Hutch是一个基于Ruby的 高效RabbitMQ消息处理系统 框架专为构建可靠的消息驱消息队列后端微服务PSR-3 日志接口规范深度解析Psr\Log\LoggerInterface 的设计原理与实战实现PSR 3 日志接口规范深度解析Psr\Log\LoggerInterface 的设计原理与实战实现 PSR 3Logger Interface日志接口文档开发工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考