ILogger 介面

Pixmicat! 內部以 ILogger 介面來識別錯誤記錄器。此 ILogger 參考 Apache 基金會 log4j API 所設計,因此容易使用及實作。程式開發者可以自行實作此介面以提供各種不同的錯誤記錄機制。

Log4j 訂立了許多錯誤層級,但 ILogger 只取了 ERROR, INFO, DEBUG 三級。ERROR 用在程式發生錯誤時記錄用,INFO 用在記錄函式執行的一些資訊,DEBUG 則大多是輸出變數診斷之用。

實作

<?php
class MyLogger implements ILogger {
    // ...
}
?>

方法

__construct

public void __construct(string $logName, string $logFile)

建構元。

參數:
$logName - Logger 名稱
$logFile - 記錄檔案位置

isDebugEnabled

public boolean isDebugEnabled()

檢查是否 logger 要記錄 DEBUG 等級。

回傳值: 要記錄 DEBUG 等級與否

isInfoEnabled

public boolean isInfoEnabled()

檢查是否 logger 要記錄 INFO 等級。

回傳值: 要記錄 INFO 等級與否

isErrorEnabled

public boolean isErrorEnabled()

檢查是否 logger 要記錄 ERROR 等級。

回傳值: 要記錄 ERROR 等級與否

debug

public void debug(string $format, object… $varargs = '')

以 DEBUG 等級記錄訊息。

參數:
$format - 格式化訊息內容。可以包含如 %s, %d, %f 的保留字以插入參數。請參考 PHP sprintf() 的 format 參數說明。
$varargs - 參數。可以有一個以上,搭配格式化訊息來輸出。

<?php
debug('This is a debug message: %s in line %d', $name, __LINE__);
?>

info

public void info(string $format, object… $varargs = '')

以 INFO 等級記錄訊息。

參數:
$format - 格式化訊息內容。請參考 debug 方法說明。
$varargs - 參數

error

public void error(string $format, object… $varargs = '')

以 ERROR 等級記錄訊息。

參數:
$format - 格式化訊息內容。請參考 debug 方法說明。
$varargs - 參數

討論

新增一則回應
登入為 Wikidot 使用者
(將不會發佈)
- +
除非特別註明,本頁內容採用以下授權方式: Creative Commons Attribution-Noncommercial-Share Alike 2.5 License.