日志
最后更新于：2022-04-02 07:07:28
## 日志
日志组件通常使用在开发环境中用来 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/tree/v2.1/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：
```
$message = 'UserId: {userId}, Name: {name}';
$context = ['userId' => 1008, 'name' => 'your name'];
$log->info($message, $context);
// 将生成 20200304[_自增编号].log 文件
```
## 日志文件
[\Mix\Log\FileHandler::class](https://github.com/mix-php/mix-skeleton/tree/v2.1/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 的依赖配置即可。
';