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, ArithmeticError | LogicException, RuntimeException, 自訂 |
<?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)
<?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']);
// 呼叫異常處理器邏輯...
}
});
<?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 {}
<?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);
}
// ❌ 錯誤:捕獲後不處理、不記錄、不重拋
try { doSomething(); } catch (Exception $e) { }
// ✅ 正確:記錄、轉換、或重拋
try { doSomething(); }
catch (SpecificException $e) {
logger()->warning($e->getMessage());
return fallback();
}
catch (Exception $e) {
logger()->error($e);
throw $e; // 重拋讓上層處理
}
ValueError:函式參數值不合法(如 strpos() offset 超出範圍)UnhandledMatchError:match 表達式無匹配分支FiberError:Fiber 相關錯誤catch (TypeError|ValueError $e)Throwable::getPrevious() 串聯異常鏈Throwable,永遠捕獲 Throwable 或具體子類別,勿只捕獲 Exception 而漏接 Error