萬盛學電腦網

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

PHP 異常處理完整指南:從基礎到進階實戰

在 PHP 開發中,異常處理是構建健壯應用程式的關鍵機制。它不僅能優雅地處理錯誤,還能將錯誤報告與業務邏輯分離,提升代碼的可維護性。本文將通過實例深入解析 PHP 異常處理的核心概念與最佳實踐。

為什麼需要異常處理?

傳統的錯誤處理方式(如返回錯誤碼)存在諸多局限:返回值類型單一、難以區分正常返回與錯誤、錯誤信息傳遞不便等。異常處理機制解決了這些問題,主要優勢包括:

  • 允許方法向調用者拋出明確的錯誤標記
  • 提供豐富的錯誤詳細信息(訊息、代碼、堆疊追蹤)
  • 支援同時判斷多種錯誤條件,實現錯誤報告與處理流程分離
  • 返回值類型獨立,避免與正常業務返回值混淆

基礎語法:try-catch 結構

PHP 使用 try 塊包裹可能拋出異常的代碼,catch 塊捕獲並處理特定類型的異常。

範例 1:資料庫連線異常處理

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

try {
    $dbh = new PDO($dsn, $user, $password); // 建立資料庫連線,易拋出 PDOException
    echo '連線成功!';
} catch (PDOException $e) {
    echo '連線失敗: ' . $e->getMessage();
}
?>

此處捕獲 PDOException,可針對資料庫錯誤進行專門處理。

範例 2:主動拋出與捕獲自定義異常

<?php
try {
    $error = '目錄不存在,拋出異常並跳出 try 區塊';
    if (is_dir('./tests')) {
        echo '執行正常邏輯';
    } else {
        throw new Exception($error, 12345); // 拋出帶代碼的異常
    }
    echo '若上方拋出異常,此行不會執行';
} catch (Exception $e) {
    echo '捕獲異常: ' . $e->getMessage() . ' 代碼: ' . $e->getCode();
}
echo '繼續執行後續程式碼';
?>

使用 throw 主動拋出異常,catch 透過 getMessage() 和 getCode() 獲取詳細信息。

進階技巧:多重 catch 區塊與自定義異常類別

針對不同業務場景,可定義繼承自 Exception 的自定義異常類別,實現精準捕獲。

<?php
// 定義自定義異常類別
class A extends Exception {}
class B extends Exception {}

$a = 20;

try {
    if ($a == 1) {
        throw new A("I am A", 1);
    } elseif ($a == 2) {
        throw new B("I am B", 2);
    } else {
        throw new Exception("Who am I ?", 0);
    }
} catch (A $e) {
    echo "類別 A 異常: " . $e->getMessage();
} catch (B $e) {
    echo "類別 B 異常: " . $e->getMessage();
} catch (Exception $e) {
    echo "通用異常: " . $e->getMessage();
}
?>

輸出結果為「通用異常: Who am I ?」,因為 $a=20 不符合前兩個條件。多重 catch 會依序匹配,子類別需置於父類別之前。

實戰建議

  • 精準捕獲:優先捕獲具體異常類別(如 PDOException),最後才捕獲基礎 Exception。
  • 異常代碼規範化:定義業務錯誤代碼常量,便於前端或監控系統識別錯誤類型。
  • 記錄日誌:在 catch 中記錄完整堆疊追蹤($e->getTraceAsString()),方便排查問題。
  • 避免吞噬異常:捕獲後應處理或重新拋出,切勿留空 catch 區塊。

總結

掌握 PHP 異常處理,能讓你的應用在面對資料庫連線失敗、檔案操作錯誤、業務邏輯異常等場景時,保持穩定且可追蹤。善用自定義異常類別與多重捕獲機制,將錯誤處理變得清晰、專業。

copyright © 萬盛學電腦網 all rights reserved