萬盛學電腦網

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

PHP Error 與 Exception 差異深度解析:從錯誤處理到現代異常體系

PHP 7 以前,Error(錯誤)與 Exception(異常)是兩套平行體系;PHP 7+ 統一繼承自 Throwable 介面,徹底改變錯誤處理方式。本文深度對比兩者差異、捕獲策略、最佳實務與框架整合。

類別繼承體系演進


// PHP 5
Exception implements Throwable (PHP 7+ 新增介面)
Error (PHP 7+ 新增) implements Throwable

// PHP 7+ 完整體系
Throwable (interface)
├── Exception (使用者代碼可拋出/捕獲)
│   ├── LogicException       // 邏輯錯誤(預先可避免)
│   │   ├── InvalidArgumentException
│   │   ├── LengthException
│   │   └── ...
│   └── RuntimeException     // 執行時錯誤(難以預測)
│       ├── OutOfBoundsException
│       ├── TypeError (PHP 7+ 也可為 Error)
│       └── ...
└── Error (引擎內部錯誤,通常不可恢復)
    ├── TypeError            // 型別不符(PHP 7+)
    ├── ParseError           // 編譯時語法錯誤
    ├── ArithmeticError      // 數學錯誤(除零等)
    ├── AssertionError       // assert() 失敗
    └── ValueError           // 參數值不合法 (PHP 8+)

關鍵差異對照

特性Error (PHP 7+)Exception
來源引擎/核心/內建函式使用者代碼 throw new Exception
可恢復性通常不可恢復(致命)設計為可捕獲處理、繼續執行
捕獲方式catch (Throwable $e) 或 catch (Error $e)catch (Exception $e)
錯誤處理器set_error_handler() (PHP 7+ 僅非致命)try-catch / set_exception_handler()
常見類型TypeError, ParseError, ArithmeticErrorLogicException, RuntimeException, 自訂

PHP 7+ 統一捕獲寫法

<?php
try {
    // 可能拋出 Exception 或 Error 的代碼
    $result = riskyOperation($input);
} catch (TypeError $e) {
    // 專門處理型別錯誤(PHP 7+)
    logError('TypeError', $e);
    return fallbackValue();
} catch (Exception $e) {
    // 處理所有使用者異常
    logError('Exception', $e);
    return errorResponse($e->getMessage());
} catch (Error $e) {
    // 捕獲其他 Engine Error (ParseError, ArithmeticError 等)
    // 生產環境通常記錄後顯示友善錯誤頁
    logCritical('Engine Error', $e);
    http_response_code(500);
    exit('系統錯誤,請稍後再試');
}
// PHP 8+ 可合寫:catch (TypeError|Exception|Error $e)

錯誤處理器 vs 異常處理器

<?php
// 1. 錯誤處理器:處理 E_WARNING, E_NOTICE, E_DEPRECATED 等非致命錯誤
set_error_handler(function(int $code, string $msg, string $file, int $line) {
    // PHP 7+ 此處不再接收 E_ERROR/E_PARSE/E_CORE_ERROR 等致命錯誤
    if (error_reporting() & $code) { // 尊重 error_reporting 設定
        throw new ErrorException($msg, 0, $code, $file, $line);
    }
    return false; // 讓 PHP 內建處理器繼續
});

// 2. 異常處理器:捕獲未被 try-catch 捕獲的 Exception
set_exception_handler(function(Throwable $e) {
    // 記錄完整堆疊
    error_log("Uncaught: [{$e->getCode()}] {$e->getMessage()} in {$e->getFile()}:{$e->getLine()}\n{$e->getTraceAsString()}");
    
    // 生產環境:顯示友善錯誤頁
    if (ini_get('display_errors')) {
        echo "

系統錯誤

我們已記錄此問題,請稍後再試。

"; } else { // 開發環境:顯示詳細資訊 echo "
{$e}
"; } }); // 3. 致命錯誤捕獲(PHP 5.2+) register_shutdown_function(function() { $error = error_get_last(); if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) { // 模擬異常處理 $e = new ErrorException($error['message'], 0, $error['type'], $error['file'], $error['line']); // 呼叫異常處理器邏輯... } });

實務最佳實務

1. 自訂異常階層(領域驅動設計)

<?php
namespace App\Exceptions;

abstract class DomainException extends \Exception {}
abstract class InfrastructureException extends \RuntimeException {}

// 具體業務異常
class InsufficientBalanceException extends DomainException {}
class UserNotFoundException extends DomainException {}
class PaymentGatewayException extends InfrastructureException {}

2. 控制器統一異常處理(Laravel 風格)

<?php
// app/Exceptions/Handler.php
public function render($request, Throwable $e) {
    if ($e instanceof ValidationException) {
        return response()->json(['errors' => $e->errors()], 422);
    }
    if ($e instanceof AuthenticationException) {
        return response()->json(['message' => 'Unauthenticated'], 401);
    }
    if ($e instanceof ModelNotFoundException) {
        return response()->json(['message' => 'Resource not found'], 404);
    }
    // 記錄所有未處理異常
    if (app()->bound('sentry')) {
        app('sentry')->captureException($e);
    }
    return parent::render($request, $e);
}

3. 避免「吞掉」異常


// ❌ 錯誤:捕獲後不處理、不記錄、不重拋
try { doSomething(); } catch (Exception $e) { }

// ✅ 正確:記錄、轉換、或重拋
try { doSomething(); } 
catch (SpecificException $e) { 
    logger()->warning($e->getMessage()); 
    return fallback(); 
}
catch (Exception $e) { 
    logger()->error($e); 
    throw $e; // 重拋讓上層處理
}

PHP 8+ 新特性

  • ValueError:函式參數值不合法(如 strpos() offset 超出範圍)
  • UnhandledMatchError:match 表達式無匹配分支
  • FiberError:Fiber 相關錯誤
  • 聯集型別捕獲:catch (TypeError|ValueError $e)
  • Throwable::getPrevious() 串聯異常鏈

總結

  • Error = 引擎層面問題,通常表示程式有 Bug 或環境異常,盡量在開發階段修復
  • Exception = 業務邏輯預期內的異常情況,應被捕獲妥善處理
  • PHP 7+ 統一實作 Throwable,永遠捕獲 Throwable 或具體子類別,勿只捕獲 Exception 而漏接 Error
  • 善用自訂異常類別表達業務語義,配合框架統一處理器實現關注點分離
copyright © 萬盛學電腦網 all rights reserved