萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 錯誤處理與異常處理完整筆記

PHP 提供錯誤處理與例外處理兩套機制。理解它們的差異、層級、最佳實務,能寫出更健壯、可維護的應用程式。

為什麼需要錯誤處理?

  • 使用者友善:避免白屏、堆疊追蹤洩露資訊
  • 開發效率:快速定位、除錯、修復
  • 安全防護:避免資訊洩露導致進一步攻擊
  • 系統穩健:優雅降級、自動恢復、監控告警

1. 最簡單處理:die()/exit()

<?php
$link = mysqli_connect('localhost', 'user', 'pass', 'db')
    or die('資料庫連線失敗: ' . mysqli_connect_error());

// 缺點:無法優雅處理、無法記錄日誌、無法釋放資源、使用者體驗差
?>

2. 自定義錯誤處理器

錯誤層級常數表

值常數說明可被自定義處理
1E_ERROR致命運行時錯誤 (記憶體耗盡等)❌
2E_WARNING運行時警告 (非致命)✅
4E_PARSE編譯時語法錯誤❌
8E_NOTICE運行時通知 (未定義變數等)✅
16E_CORE_ERRORPHP 啟動致命錯誤❌
32E_CORE_WARNINGPHP 啟動警告❌
64E_COMPILE_ERROR編譯致命錯誤❌
128E_COMPILE_WARNING編譯警告❌
256E_USER_ERROR用戶 trigger_error 產生✅
512E_USER_WARNING用戶警告✅
1024E_USER_NOTICE用戶通知✅
2048E_STRICT程式碼改進建議✅
4096E_RECOVERABLE_ERROR可捕獲致命錯誤 (型別錯誤等)✅
8192E_DEPRECATED棄用功能警告✅
16384E_USER_DEPRECATED用戶棄用警告✅
32767E_ALL所有錯誤 (PHP 8.0+ 包含 E_STRICT)-

設定自定義處理器

<?php
function customErrorHandler(int $level, string $message, string $file, int $line, array $context = []): bool {
    // 1. 記錄日誌
    $log = sprintf(
        "[%s] %s: %s in %s:%d\n",
        date('Y-m-d H:i:s'),
        getErrorLevelName($level),
        $message,
        $file, $line
    );
    error_log($log, 3, __DIR__ . '/logs/errors.log');
    
    // 2. 開發環境顯示
    if (ini_get('display_errors')) {
        echo "
$log
"; } // 3. 致命錯誤不返回 true (讓內建處理器終止腳本) if (in_array($level, [E_ERROR, E_PARSE, E_CORE_ERROR, E_CORE_WARNING, E_COMPILE_ERROR, E_COMPILE_WARNING])) { return false; } return true; // 阻止內建處理器 } function getErrorLevelName(int $level): string { $levels = [ E_ERROR => 'ERROR', E_WARNING => 'WARNING', E_PARSE => 'PARSE', E_NOTICE => 'NOTICE', E_CORE_ERROR => 'CORE_ERROR', E_CORE_WARNING => 'CORE_WARNING', E_COMPILE_ERROR => 'COMPILE_ERROR', E_COMPILE_WARNING => 'COMPILE_WARNING', E_USER_ERROR => 'USER_ERROR', E_USER_WARNING => 'USER_WARNING', E_USER_NOTICE => 'USER_NOTICE', E_STRICT => 'STRICT', E_RECOVERABLE_ERROR => 'RECOVERABLE_ERROR', E_DEPRECATED => 'DEPRECATED', E_USER_DEPRECATED => 'USER_DEPRECATED', ]; return $levels[$level] ?? 'UNKNOWN'; } set_error_handler('customErrorHandler', E_ALL | E_STRICT); // 觸發測試 trigger_error("這是用戶警告", E_USER_WARNING); ?>

觸發錯誤 trigger_error()

<?php
// 驗證用戶輸入
$age = $_POST['age'] ?? 0;
if (!is_numeric($age) || $age < 0 || $age > 150) {
    trigger_error("無效年齡輸入: $age", E_USER_WARNING);
    // 可選:拋出例外代替
    // throw new InvalidArgumentException("無效年齡: $age");
}
?>

3. 錯誤日誌記錄 error_log()

<?php
// 發送到系統日誌 (syslog/event log)
error_log("資料庫連線失敗", 0);

// 發送郵件通知管理員
error_log("嚴重錯誤: $message", 1, "admin@example.com", "From: system@example.com");

// 寫入自定義檔案
error_log("除錯資訊: $var", 3, __DIR__ . "/logs/debug.log");
?>

4. 異常處理 (Exception Handling)

基本結構

<?php
try {
    // 可能拋出異常的代碼
    $result = riskyOperation($input);
} catch (SpecificException $e) {
    // 處理特定異常
    logger()->error($e->getMessage());
    return fallbackResponse();
} catch (Exception $e) {
    // 捕獲其他異常
    logger()->critical($e->getMessage());
    throw $e; // 重新拋出
} finally {
    // 清理資源 (一定會執行)
    cleanupResources();
}
?>

異常處理規則

  • try 區塊包含可能拋出異常的代碼
  • 每個 throw 至少對應一個 catch
  • 多個 catch 可捕獲不同類型異常 (子類別優先)
  • finally 區塊總是執行 (即使有 return/throw)
  • 未捕獲異常 → set_exception_handler → Fatal Error

自定義異常類別

<?php
class AppException extends Exception {
    protected int $code = 500;
    public function __construct(string $message = "", int $code = 0, Throwable $previous = null) {
        parent::__construct($message, $code ?: $this->code, $previous);
    }
}

class ValidationException extends AppException {
    protected int $code = 422;
    public array $errors = [];
    
    public function __construct(array $errors, string $message = "驗證失敗") {
        $this->errors = $errors;
        parent::__construct($message);
    }
}

class NotFoundException extends AppException {
    protected int $code = 404;
}
?>

重新拋出異常 (轉換為用戶友善訊息)

<?php
try {
    $user = User::findOrFail($id);
} catch (ModelNotFoundException $e) {
    // 系統錯誤 → 用戶友善錯誤
    throw new NotFoundException("找不到指定用戶");
} catch (QueryException $e) {
    // 記錄詳細錯誤給開發者
    logger()->error("DB Error: " . $e->getMessage());
    // 回傳通用訊息給用戶
    throw new AppException("系統暫時無法處理請求,請稍後再試");
}
?>

5. 錯誤 vs 異常:何時用哪個?

特性錯誤異常
來源PHP 核心、擴展、trigger_error程式碼主動 throw、第三方庫
可捕獲set_error_handler (部分)try/catch 完全捕獲
型別系統整數層級常數類別繼承體系
堆疊追蹤無 (需 debug_backtrace)內建 getTrace()
適用場景非預期系統錯誤、舊代碼相容業務邏輯錯誤、可預期失敗、流程控制

現代 PHP 最佳實務 (PHP 7/8+)

  1. 優先使用異常:業務邏輯錯誤拋出具體異常類別
  2. 錯誤轉異常:用 ErrorException 將錯誤統一為異常
    set_error_handler(function($level, $msg, $file, $line) {
        if (error_reporting() & $level) {
            throw new ErrorException($msg, 0, $level, $file, $line);
        }
    });
  3. 統一錯誤回應:中介層捕獲所有異常,輸出標準 JSON/API 格式
  4. 結構化日誌:Monolog + JSON 格式,便於 ELK/Splunk 分析
  5. 不要吞沒異常:catch (Exception $e) { } 是大忌,至少要 log
copyright © 萬盛學電腦網 all rights reserved