萬盛學電腦網

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

PHP 例外處理完整指南:try-catch、自訂例外與多重捕獲實戰

什麼是例外?

PHP 5 引入物件導向的錯誤處理機制——例外。當程式執行遇到特定錯誤條件時,例外會中斷正常流程,將控制權移交給預先定義的處理器。處理器可選擇恢復執行、終止腳本或跳轉至其他邏輯。例外僅應用於真正的錯誤情境,不可濫用於一般流程控制。

基本結構:try、throw、catch

<?php
function checkNum($number) {
    if ($number > 1) {
        throw new Exception("數值必須為 1 或更小");
    }
    return true;
}

try {
    checkNum(2);
    echo '若看到此訊息,表示數值合法';
} catch (Exception $e) {
    echo '錯誤訊息:' . $e->getMessage();
}
?>

未被捕獲的例外會觸發 Fatal Error: Uncaught Exception。每個 throw 至少需對應一個 catch,或由頂層處理器攔截。

自訂例外類別

繼承 Exception 類別,即可擴充自訂屬性與方法:

<?php
class CustomException extends Exception {
    public function errorMessage() {
        return "第 {$this->getLine()} 行發生錯誤於 {$this->getFile()}:" 
             . "{$this->getMessage()} 非有效 Email 格式";
    }
}

$email = "invalid-email";
try {
    if (filter_var($email, FILTER_VALIDATE_EMAIL) === false) {
        throw new CustomException($email);
    }
} catch (CustomException $e) {
    echo $e->errorMessage();
}
?>

多重例外捕獲

可針對不同條件拋出不同例外類別,並依序捕獲:

<?php
$email = "user@example.com";
try {
    if (filter_var($email, FILTER_VALIDATE_EMAIL) === false) {
        throw new CustomException($email);
    }
    if (strpos($email, 'example') !== false) {
        throw new Exception("$email 為範例信箱");
    }
} catch (CustomException $e) {
    echo $e->errorMessage();
} catch (Exception $e) {
    echo $e->getMessage();
}
?>

捕獲順序遵循「子類別優先」,若無對應 catch,會向上層尋找。

重新拋出例外

在 catch 區塊中可再次拋出例外,常用於將系統錯誤轉為使用者友善訊息:

<?php
try {
    try {
        if (strpos($email, 'example') !== false) {
            throw new Example($email);
        }
    } catch (Exception $e) {
        throw new CustomException($email); // 重新拋出
    }
} catch (CustomException $e) {
    echo $e->errorMessage();
}
?>

頂層例外處理器

使用 set_exception_handler() 設定全域未捕獲例外處理函數:

<?php
function myHandler($exception) {
    echo "未捕獲例外: {$exception->getMessage()}";
}
set_exception_handler('myHandler');
throw new Exception('未處理的錯誤');
?>

例外處理黃金法則

  • 程式碼區塊用 try 包裹潛在風險區段。
  • 每個 try 或 throw 至少對應一個 catch。
  • 可使用多個 catch 處理不同例外類別。
  • catch 區塊內可再次拋出例外。
  • 核心原則:拋出即必須捕獲。

妥善運用例外機制,能讓錯誤處理邏輯與業務邏輯分離,提升程式碼健壯性與可維護性。

copyright © 萬盛學電腦網 all rights reserved