PHP 錯誤級別完整指南：分類、配置、日誌與最佳實踐

PHP 錯誤級別完整指南：分類、配置、日誌與最佳實踐

錯誤報告是 PHP 開發調試的「儀表盤」。正確理解錯誤層級、靈活配置報告策略、建立生產級日誌體系，能讓你從「看報錯」進化到「預防錯、快速定位錯、優雅處理錯」。

一、錯誤級別層級圖譜（由低到高）

註： E_ALL (32767) 包含除 E_STRICT 外所有級別（PHP 5.4+ E_STRICT 已併入 E_ALL）。

二、配置策略：開發 vs 生產

1. php.ini 核心指令

; 錯誤報告級別位掩碼
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT  ; 開發建議
error_reporting = E_ALL & ~E_NOTICE & ~E_DEPRECATED    ; 生產常見

; 是否在輸出中顯示錯誤
display_errors = On   ; 開發環境
display_errors = Off  ; 生產環境（嚴禁開啟，防信息洩露）

; 是否記錄錯誤日誌
log_errors = On
error_log = /var/log/php/error.log  ; 絕對路徑，確保目錄可寫

; 日誌最大長度（0 不限制）
log_errors_max_len = 1024

; 忽略重複錯誤
ignore_repeated_errors = Off
ignore_repeated_source = Off

2. 運行時動態調整

<?php
// 僅影響當前腳本及後續 include 文件
error_reporting(E_ALL);           // 開發：報告所有
error_reporting(E_ALL & ~E_NOTICE); // 忽略 Notice
error_reporting(0);               // 關閉報告（慎用）

// 獨立控制顯示與記錄
ini_set('display_errors', '1');   // 瀏覽器顯示
ini_set('log_errors', '1');       // 寫入日誌
ini_set('error_log', '/tmp/my.log'); // 指定日誌文件

// 組合策略：開發全顯、生產只記不顯
if (APP_ENV === 'dev') {
    error_reporting(-1); // -1 等同 E_ALL，包含未來新增級別
    ini_set('display_errors', '1');
} else {
    error_reporting(E_ALL & ~E_NOTICE & ~E_DEPRECATED);
    ini_set('display_errors', '0');
    ini_set('log_errors', '1');
    ini_set('error_log', LOG_DIR . '/php_error.log');
}
?>

三、自定義錯誤處理：從錯誤到異常

利用 set_error_handler() 將非致命錯誤轉為 ErrorException，統一進入 try-catch 流程：

<?php
function exceptionErrorHandler($severity, $message, $file, $line) {
    if (!(error_reporting() & $severity)) return false; // 當前級別未開啟報告
    throw new ErrorException($message, 0, $severity, $file, $line);
}
set_error_handler('exceptionErrorHandler');

// 現在可捕獲 Warning/Notice
try {
    $arr = [];
    echo $arr['missing_key']; // 原產生 Notice，現拋出 ErrorException
} catch (ErrorException $e) {
    Log::warning('捕獲轉換異常', ['msg' => $e->getMessage(), 'file' => $e->getFile()]);
}

// 致命錯誤需註冊關閉函數捕獲
register_shutdown_function(function() {
    $error = error_get_last();
    if ($error && in_array($error['type'], [E_ERROR, E_CORE_ERROR, E_COMPILE_ERROR, E_PARSE])) {
        Log::emergency('致命錯誤', $error);
        // 發送告警、渲染友好錯誤頁
    }
});

四、用戶觸發錯誤：trigger_error()

<?php
// 業務邏輯中主動上報
if ($stock < $buyNum) {
    trigger_error("商品 {$goodsId} 庫存不足: {$stock} < {$buyNum}", E_USER_WARNING);
    return false; // 繼續執行降級邏輯
}

if (empty($config['app_key'])) {
    trigger_error('核心配置 app_key 缺失', E_USER_ERROR); // 腳本終止
}

五、生產環境日誌最佳實踐

1. 結構化日誌： 採用 JSON 格式，包含 timestamp, level, message, context(trace_id, user_id, request_id, code_stack)，便於 ELK/Splunk 接入分析。
2. 分級存儲： error.log (ERROR+), warning.log (WARNING), info.log (NOTICE/INFO)，避免單文件過大。
3. 日誌輪轉： 配置 logrotate 每日切割、壓縮、保留 30 天，防止磁盤爆滿。
4. 敏感信息脫敏： 自動過濾密碼、Token、身份證、銀行卡等字段（正則替換為 ***）。
5. 告警接入： ERROR 級別實時推送至 Slack/DingTalk/PagerDuty，關鍵業務錯誤秒級響應。

六、PHP 7/8 變化重點

• EngineException → Error 體系： 類型錯誤、參數錯誤現在拋出 TypeError, ArgumentCountError 等 Error 子類，**不再觸發 E_RECOVERABLE_ERROR**，需 catch (Throwable $e) 捕獲（Exception 捕獲不到）。
• E_STRICT 移除： PHP 7 起併入 E_ALL，無需單獨處理。
• 動態屬性棄用 (PHP 8.2+)： 未聲明屬性賦值觸發 E_DEPRECATED，建議聲明屬性或用 #[\AllowDynamicProperties]。
• 只讀屬性/返回類型協變/逆變： 類型系統收緊，編譯期發現更多錯誤，減少運行時 E_ERROR。

七、速查表：常用配置組合

總結

錯誤級別不是枯燥的常量表，而是「可觀測性」的分層開關。掌握：

1. 分級語義：Notice=代碼氣味、Warning=運行異常、Error=必須修復、Parse=阻斷部署。
2. 環境隔離：開發全開、生產只記不顯、日誌結構化、告警自動化。
3. 異常統一：set_error_handler + register_shutdown_function 將錯誤納入異常體系，單一處理入口。
4. 版本演進：PHP 7/8 將更多錯誤前移至編譯期/類型系統，順勢升級減少運行時驚喜。

把錯誤當作「系統在對你說話」，配置得當，它就是最忠實的質量衛士。