在現代應用程式開發中,日誌系統的重要性不言而喻。無論是記錄錯誤資訊、除錯細節、運行狀態還是效能指標,完善的日誌機制都是生產環境中排查問題、監控系統健康的關鍵基礎設施。本文介紹一個基於 PHP 單例模式設計的日誌處理類庫,具備自動分割大檔案、資源復用等實用特性。
採用單例模式確保全域僅存在一個日誌實例,避免重複開啟檔案控制代碼,減少系統開銷。私有建構子搭配靜態 get_instance() 方法,提供全域唯一存取點。
類別內建檔案大小監控邏輯:當日誌檔案超過預設閾值(LOG_MAX_LEN)時,自動按序號建立新檔案(如 log_0、log_1…),無需人工干預。掃描目錄下現有檔案後綴,找出最大編號並檢查大小,決定是否滾動建立新檔。
class Log {
private static $instance = null;
private static $handle = null;
private $log_switch;
private $log_file_path;
private $log_max_len;
private $log_file_pre = 'log_';
protected function __construct() {
$this->log_file_path = LOG_FILE_PATH;
$this->log_switch = LOG_SWITCH;
$this->log_max_len = LOG_MAX_LEN;
}
public static function get_instance() {
if (!self::$instance instanceof self) {
self::$instance = new self;
}
return self::$instance;
}
public function log($type, $desc, $time) { ... }
private function get_max_log_file_suf() { ... }
public function close() { fclose(self::$handle); }
}
0 代表一般事件(THING LOG),1 代表錯誤(ERROR LOG),預設視為事件。get_max_log_file_suf() 取得最新可用檔案名。chr(13) 作為行尾符號。log_數字 格式的檔名。$log_file_suf。$this->log_max_len,則編號 +1 以建立新檔。0。// 取得單例
$logger = Log::get_instance();
// 記錄錯誤日誌
$logger->log(1, '資料庫連線失敗', date('Y-n-j H:i:s'));
// 記錄一般事件
$logger->log(0, '使用者登入成功', date('Y-n-j H:i:s'));
// 關閉檔案控制代碼(通常於腳本結束前呼叫)
$logger->close();
部署前請在配置檔中定義以下常數:
LOG_FILE_PATH:日誌檔案儲存目錄(需可寫入)LOG_SWITCH:日誌開關(true/false)LOG_MAX_LEN:單一檔案最大位元組數(如 1048576 代表 1MB)flock)或改用專用日誌元件(如 Monolog)。這個日誌類別展示了單例模式在資源管理上的典型應用,配合自動分檔機制,適合中小型專案快速整合。對於大型分散式系統,建議採用集中式日誌解決方案(ELK Stack、Loki 等)以利查詢與分析。