萬盛學電腦網

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

PHP 異常處理進階:BadMethodCallException 與自定義異常體系實戰

SPL 異常體系與 BadMethodCallException

BadMethodCallException 屬 PHP 標準庫(SPL)內建異常,繼承鏈:

BadMethodCallException extends BadFunctionCallException extends Exception

常見於框架源碼(如 Yii2):

namespace yii\base;
class InvalidCallException extends \BadMethodCallException {
    public function getName() { return 'Invalid Call'; }
}

實戰場景:控制器中的異常捕獲

public function actionResetPassword($token)
{
    try {
        $model = new ResetPasswordForm($token);
    } catch (InvalidParamException $e) {
        throw new BadRequestHttpException($e->getMessage());
    }

    if ($model->load(Yii::$app->request->post()) 
        && $model->validate() 
        && $model->resetPassword()) {
        Yii::$app->session->setFlash('success', 'New password was saved.');
        return $this->goHome();
    }
    return $this->render('resetPassword', ['model' => $model]);
}

PHP 內建 Exception 類詳解

核心屬性與方法:

  • $message - 異常信息
  • $code - 自定義代碼
  • $file - 發生文件
  • $line - 行號
  • getTrace() - 堆疊跟蹤數組
  • getTraceAsString() - 格式化堆疊字符串

基本用法

try {
    $error = 'my error!';
    throw new Exception($error);
} catch (Exception $e) {
    echo $e->getMessage(); // my error!
}

自定義異常類最佳實踐

class MyException extends Exception {
    // 強制要求 message 參數
    public function __construct($message, $code = 0) {
        parent::__construct($message, $code);
    }
    // 自定義字符串輸出
    public function __toString() {
        return __CLASS__ . ": [{$this->code}]: {$this->message}\n";
    }
    public function customFunction() {
        echo "A Custom function for this type of exception\n";
    }
}

異常處理核心機制

  • 拋出: throw new Exception('message', code); — throw 是語言結構非函數
  • 捕獲: 至少一個 catch 塊,可多個捕獲不同類型
  • 流程: try 塊拋出異常 → 尋找匹配 catch → 執行 catch → try 後續代碼不再執行
  • 未捕獲: 觸發 Uncaught exception 致命錯誤

實戰:用戶註冊驗證異常處理

try {
    if (!filled_out($_POST)) {
        throw new Exception('請完整填寫表單');
    }
    if (!check_email($email)) {
        throw new Exception('郵箱格式不正確');
    }
    if (strlen($passwd) < 6) {
        throw new Exception('密碼長度需大於 6 位');
    }
    if ($passwd !== $passwd1) {
        throw new Exception('兩次密碼不一致');
    }
    if (strlen($username) > 16) {
        throw new Exception('用戶名過長');
    }
} catch (Exception $e) {
    echo $e->getMessage(); // 統一輸出錯誤
}

關鍵注意點

  1. 異常必須手動 throw,PHP 不會自動拋出(Java 會)
  2. catch 參數建議用具體子類,避免捕獲過廣
  3. 異常不應用於正常流程控制,僅用於錯誤/異常狀態
  4. 生產環境記錄完整堆疊(getTraceAsString())而非直接輸出
copyright © 萬盛學電腦網 all rights reserved