## 日志 日志组件通常使用在开发环境中用来 debug,生产环境中监控程序异常与运行状态,基于 [PSR-3](https://www.php-fig.org/psr/psr-3/) 标准实现。 ## 组件 使用 [composer]([https://www.phpcomposer.com/](https://www.phpcomposer.com/)) 安装: ~~~ composer require mix/log ~~~ ## 依赖注入配置 - [beans/log.php](https://github.com/mix-php/mix-skeleton/blob/master/manifest/beans/log.php) `rotate` 全部常量明细: - Mix\Log\FileHandler::ROTATE_HOUR - Mix\Log\FileHandler::ROTATE_DAY - Mix\Log\FileHandler::ROTATE_WEEKLY ## 获取实例 通过依赖配置获取实例: ~~~ /** @var \Mix\Log\Logger $log */ $log = context()->get('log'); ~~~ ## PSR 定义方法 | 方法 | | --- | | emergency($message, array $context = []) : bool | | alert($message, array $context = []) : bool | | critical($message, array $context = []) : bool | | error($message, array $context = []) : bool | | warning($message, array $context = []) : bool | | notice($message, array $context = []) : bool | | debug($message, array $context = []) : bool | | log($level, $message, array $context = []) : bool | - Sample 1: ``` $message = 'UserId: {userId}, Name: {name}'; $context = ['userId' => 1008, 'name' => 'your name']; $log->info($message, $context); // 将生成 info_轮转时间[_自增编号].log 文件 ``` - Sample 2:可以自定义输出日志到某个文件: ~~~ $message = 'UserId: {userId}, Name: {name}'; $context = ['userId' => 1008, 'name' => 'your name']; $log->log('test', $message, $context); // 将生成 test_轮转时间[_自增编号].log 文件 ~~~ ## 日志文件 [\Mix\Log\FileHandler::class](https://github.com/mix-php/mix-skeleton/blob/master/manifest/beans/log.php#L41) 负责将日志写入到文件: - 日志目录:保存在 `dir` 属性定义的位置,需绝对路径。 - 日志文件格式:`文件前缀_轮转时间[_自增编号].log` ## 日志记录级别 配置中的 `levels` 字段设定了写入日志的级别,没有定义在里面的日志类型,不管是被动调用还是主动掉用,都不会写入到日志文件。 >[info] 日志记录级别对用户定义的新类型无效,比如上面 log 方法的 test 类型。 - 只记录 'error', 'info', 'debug' 日志,忽略其他类型的日志: ~~~ 'level' => ['error', 'info', 'debug'], ~~~ ## 自定义日志处理 Mix\Log\MultiHandler::class 可以传入任意多个日志处理器,其中 Mix\Log\StdoutHandler::class 是必须传入的,否则错误会没有终端输出,看不到程序的异常。 当用户想自己处理日志时 (比如使用 [monolog/monolog](https://packagist.org/packages/monolog/monolog)),可创建一个实现 Mix\Log\LoggerHandlerInterface 接口的 Handler 类,在内部使用 monolog 处理不同级别的日志,然后在 manifest.php 中把 Handler 类传入 MultiHandler::class 的依赖配置即可。