## 日志 日志組件通常使用在開發環境中用來 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 的依賴配置即可。