萬盛學電腦網

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

PHP 5 異常處理機制深度解析與實戰案例

PHP 5 異常處理核心概念

PHP 5 引入面向對象的異常處理模型,類似 Java/C#。關鍵字:try、catch、throw、Exception 類。異常流程:try 塊中拋出異常 → catch 捕獲處理 → 程序繼續執行。

內置 Exception 類結構

class Exception {
    protected $message = 'Unknown exception'; // 異常信息
    protected $code = 0;                      // 用戶自定義代碼
    protected $file;                          // 發生異常文件
    protected $line;                          // 發生異常行號

    public function __construct($message = null, $code = 0);
    final public function getMessage();       // 獲取信息
    final public function getCode();          // 獲取代碼
    final public function getFile();          // 獲取文件
    final public function getLine();          // 獲取行號
    final public function getTrace();         // 回溯數組
    final public function getTraceAsString(); // 回溯字符串

    // 可重寫
    public function __toString();             // 字符串表示
}

語法結構

1. try...catch 基本形式

try {
    // 可能拋出異常的代碼(如數據庫連接、文件操作)
} catch (Exception $e) {
    // 處理異常
    echo '捕獲異常: ' . $e->getMessage();
}

2. throw 主動拋出異常

$message = '業務邏輯錯誤';
$code = 1001;
throw new Exception($message, $code);

注意:PHP 無 throws 關鍵字,異常聲明靠文檔規範。

實戰案例

案例 1:PDO 數據庫連接異常處理

<?php
$dsn = 'mysql:host=localhost;dbname=testdb;charset=utf8mb4';
$user = 'dbuser';
$password = 'dbpass';

try {
    $dbh = new PDO($dsn, $user, $password, [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, // 關鍵:設置錯誤模式為異常
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    ]);
    echo '數據庫連接成功';
    // 執行查詢...
} catch (PDOException $e) {
    // PDOException 繼承自 Exception
    error_log('DB Connection Failed: ' . $e->getMessage());
    die('數據庫連接失敗,請稍後重試');
}
?>

案例 2:業務邏輯異常與自定義異常類

<?php
// 自定義異常類
class BusinessException extends Exception {
    public function __construct($message, $code = 0, Exception $previous = null) {
        parent::__construct($message, $code, $previous);
    }
    public function __toString() {
        return __CLASS__ . ": [{$this->code}]: {$this->message}\n";
    }
}

function checkDirectory($path) {
    if (!is_dir($path)) {
        throw new BusinessException("目錄不存在: $path", 404);
    }
    return true;
}

try {
    checkDirectory('./tests');
    echo '目錄存在,執行業務邏輯...';
} catch (BusinessException $e) {
    echo '業務異常: ' . $e->getMessage() . ' (代碼: ' . $e->getCode() . ')';
} catch (Exception $e) {
    echo '未知系統異常: ' . $e->getMessage();
}
echo '<br>程序繼續執行...';
?>

多重 catch 與異常鏈

try {
    // ...
} catch (SpecificException1 $e) {
    // 處理特定異常 1
} catch (SpecificException2 $e) {
    // 處理特定異常 2
} catch (Exception $e) {
    // 兜底處理所有其他異常
    // 可選:重新拋出
    // throw $e;
}

捕獲順序:子類在前,父類在後。

全局異常處理器

設置未捕獲異常的回調,避免暴露敏感堆棧信息:

function globalExceptionHandler(Throwable $e) {
    http_response_code(500);
    error_log('Uncaught Exception: ' . $e->getMessage() . ' in ' . $e->getFile() . ':' . $e->getLine());
    // 生產環境顯示友好錯誤頁
    include __DIR__ . '/templates/500.php';
    exit;
}
set_exception_handler('globalExceptionHandler');

PHP 7+ 使用 Throwable 接口捕獲 Error 和 Exception。

最佳實踐總結

  1. 異常用於異常情況:不要用於正常流程控制(如判斷數組鍵是否存在用 isset())。
  2. 具體捕獲:優先捕獲具體異常類,避免吞噬未預期錯誤。
  3. 豐富異常信息:自定義異常類攜帶上下文數據(用戶 ID、請求 ID 等),便於排查。
  4. 日誌記錄:catch 塊中務必記錄完整堆棧($e->getTraceAsString())。
  5. 不吞噬異常:除非已妥善處理,否則重新拋出或轉化為更高層異常。
  6. 資源清理:使用 finally (PHP 5.5+) 關閉連接、釋放鎖、清理臨時文件。

結語

PHP 異常處理機制雖起步晚,但已足夠強大支撐企業級應用開發。合理使用異常層級、自定義異常類、全局處理器,能構建健壯、可維護的錯誤處理體系。

copyright © 萬盛學電腦網 all rights reserved