>[danger] 該組件為系統組件，在組件樹中只可命名為 log ，不可修改為其他名稱。 ## 日志 日志組件通常使用在開發環境中用來debug，生產環境中監控程序異常與運行狀態。 | 類 | 調用 | | --- | --- | | mix\base\Log | app()->log | | 門面類 | 調用 | | --- | --- | | mix\facades\Log | Log:: | ## 數據庫配置 App配置文件中，該組件的默認配置如下： ~~~ // 日志 'log' => [ // 類路徑 'class' => 'mix\base\Log', // 日志記錄級別 'level' => ['error', 'info', 'debug'], // 日志目錄 'logDir' => 'logs', // 日志輪轉類型 'logRotate' => mix\base\Log::ROTATE_DAY, // 最大文件尺寸 'maxFileSize' => 0, // 換行符 'newline' => PHP_EOL, // 在寫入時加獨占鎖 'writeLock' => false, ], ~~~ `logRotate` 全部常量明細： - mix\base\Log::ROTATE_HOUR - mix\base\Log::ROTATE_DAY - mix\base\Log::ROTATE_WEEKLY ## 日志類型 全部日志類型如下： - **debug**：調試日志 - **info**：信息日志 - **error**：錯誤日志 ## 日志文件 生成的日志文件默認在 `runtime/logs` 目錄，也可以使用絕對路徑定義為其他目錄，日志文件格式如下： ~~~txt 文件前綴_輪轉時間_[自增編號].log ~~~ ## 自定義日志 可以自定義輸出日志到某個文件，`$message` 只能為字符型，且沒有時間信息，需要用戶自己封裝將 array/object 轉換為 json 字符型，然后增加時間信息。 ~~~ Log::write($filePrefix, $message) ~~~ ## 調試日志 ~~~ Log::debug($message); ~~~ ## 信息日志 ~~~ Log::info($message); ~~~ ## 寫入錯誤日志 錯誤日志是被動的，當應用運行出現異常時框架自動記錄。 ~~~ Log::error($message); ~~~ ## 日志記錄級別 配置中的 `level` 字段設定了寫入日志的級別，沒有定義在里面的日志類型，不管是被動調用還是主動掉用，都不會寫入到日志文件。 >[info] 日志記錄級別對 write 方法無效。 ~~~ 'level' => ['error', 'info', 'debug'], ~~~ 例如：只記錄錯誤日志，忽略其他類型的日志，配置如下： ~~~ 'level' => ['error'], ~~~