>[danger] 該組件為系統組件，在組件樹中只可命名為 log ，不可修改為其他名稱。 ## 日志 日志組件通常使用在開發環境中用來 debug，生產環境中監控程序異常與運行狀態。 | 類 | 調用 | | --- | --- | | Mix\Log\Logger | app()->log | >[success] 日志組件實現了 Psr\Log\LoggerInterface ，符合 PSR 標準。 ## 依賴注入配置 [>> 到 GitHub 查看默認配置 <<](https://github.com/mix-php/mix/blob/v2/applications/http/config/main_coroutine.php#L90) `rotate` 全部常量明細： - Mix\Log\FileHandler::ROTATE_HOUR - Mix\Log\FileHandler::ROTATE_DAY - Mix\Log\FileHandler::ROTATE_WEEKLY ## 日志類型 全部日志類型如下： ``` 'emergency', 'alert', 'critical', 'error', 'warning', 'notice', 'info', 'debug' ``` >[info] 每個類型都對應一個 Log 類的同名方法。 使用方法： ``` $message = 'UserId: {userId}, Name: {name}'; $context = ['userId' => 1008, 'name' => 'your name']; app()->log->info($message, $context); // 將生成 info_輪轉時間_[自增編號].log 文件 ``` ## 自定義日志 可以自定義輸出日志到某個文件： ~~~ $message = 'UserId: {userId}, Name: {name}'; $context = ['userId' => 1008, 'name' => 'your name']; app()->log->log('test', $message, $context); // 將生成 test_輪轉時間_[自增編號].log 文件 ~~~ ## 日志文件 生成的日志文件默認在 `runtime/logs` 目錄，也可以使用絕對路徑定義為其他目錄，日志文件格式如下： ~~~txt 文件前綴_輪轉時間_[自增編號].log ~~~ ## 日志記錄級別 配置中的 `level` 字段設定了寫入日志的級別，沒有定義在里面的日志類型，不管是被動調用還是主動掉用，都不會寫入到日志文件。 >[info] 日志記錄級別對用戶定義的新類型無效，比如上面定義的 test 類型。 ~~~ 'level' => ['error', 'info', 'debug'], ~~~ 例如：只記錄錯誤日志，忽略其他類型的日志，配置如下： ~~~ 'level' => ['error'], ~~~