PHP 錯誤處理與日誌記錄完整指南

簡介

PHP 提供完整的錯誤處理與日誌機制：自訂錯誤處理器、例外處理器、觸發使用者錯誤、記錄至檔案/系統日誌/郵件、錯誤報告層級控制、顯示/隱藏錯誤等。所有函數內建核心，無需安裝。

執行期設定 (php.ini 關鍵指令)

核心函數

錯誤層級常數

最佳實踐範例

1. 開發環境完整錯誤顯示

<?php
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
error_reporting(E_ALL);
?>

2. 生產環境記錄不顯示

<?php
ini_set('display_errors', '0');
ini_set('log_errors', '1');
ini_set('error_log', '/var/log/php/error.log');
error_reporting(E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED);
?>

3. 自訂錯誤處理器 (將錯誤轉為例外)

<?php
function exceptionErrorHandler($severity, $message, $file, $line) {
    if (!(error_reporting() & $severity)) return;
    throw new ErrorException($message, 0, $severity, $file, $line);
}
set_error_handler('exceptionErrorHandler');

try {
    // 程式碼...
} catch (ErrorException $e) {
    error_log($e->getMessage());
    // 友善錯誤頁面
}
?>

4. 記錄自訂錯誤到檔案

<?php
error_log("訂單處理失敗: OrderID=$orderId", 3, "/var/log/app/orders.log");
?>

關鍵建議

• 生產環境 絕不 開啟 display_errors，避免洩露敏感資訊。
• 統一使用例外處理，配合 set_exception_handler 進行全域捕獲與記錄。
• 日誌檔案權限確保 Web 使用者可寫，並定期輪轉 (logrotate)。
• 使用 error_get_last() 在關閉腳本前檢查致命錯誤 (register_shutdown_function)。