piotrpress / logger
此库与PSR-3文件记录器实现兼容。
v2.0.0
2024-09-15 20:19 UTC
Requires
- php: >=7.4
- piotrpress/templater: ^1.2.0
- psr/log: ^1.1.4
This package is auto-updated.
Last update: 2024-09-15 20:19:58 UTC
README
此库与PSR-3文件记录器实现兼容。
安装
composer require piotrpress/logger
示例
require __DIR__ . '/vendor/autoload.php'; use PiotrPress\Logger; use PiotrPress\Logger\FileHandler; use PiotrPress\Logger\ErrorLogHandler; $logger = new Logger( new FileHandler( __DIR__ . '/' . date( 'Y-m-d' ) . '.log' ), new ErrorLogHandler() ); $logger->error( '[{module}] Example error', [ 'module' => 'Core' ] );
保存:将 [error] [Core] Example error
写入文件:{Y-m-d}.log
并发送到PHP错误日志。
记录器
Logger 可以接受任意数量的实现 HandlerInterface 的处理器作为构造函数参数。
处理器
- ErrorLogHandler - 将日志发送到PHP错误日志。
- FileHandler - 将日志发送到文件。
注意: 两个处理器都支持可选的 FormatterInterface 参数。
格式化器
- ErrorLogFormatter - 使用 LogRecord 通过 error_log 模板格式化。
- FileFormatter - 使用 LogRecord 通过 file 模板格式化。
注意: 两个格式化器都支持可选的 template
参数的路径。
级别
记录器支持八个日志方法,以将日志写入八个 RFC 5424 级别(debug
、info
、notice
、warning
、error
、critical
、alert
、emergency
)和一个第九个方法 log
,该方法接受日志级别作为第一个参数。
上下文
所有记录器日志方法都支持可选的 context
数组参数。
所有额外的 context
数组值,在字符串中评估,可以根据 PSR-3 指南使用相应的键在单个开括号 {
和单个闭括号 }
之间放入 message
中使用。
上下文值还可以在 templates
文件中作为常规PHP变量使用。
要求
支持PHP >= 7.4
版本。