PHP 提供錯誤處理與例外處理兩套機制。理解它們的差異、層級、最佳實務,能寫出更健壯、可維護的應用程式。
為什麼需要錯誤處理?
- 使用者友善:避免白屏、堆疊追蹤洩露資訊
- 開發效率:快速定位、除錯、修復
- 安全防護:避免資訊洩露導致進一步攻擊
- 系統穩健:優雅降級、自動恢復、監控告警
1. 最簡單處理:die()/exit()
<?php
$link = mysqli_connect('localhost', 'user', 'pass', 'db')
or die('資料庫連線失敗: ' . mysqli_connect_error());
// 缺點:無法優雅處理、無法記錄日誌、無法釋放資源、使用者體驗差
?>
2. 自定義錯誤處理器
錯誤層級常數表
| 值 | 常數 | 說明 | 可被自定義處理 |
| 1 | E_ERROR | 致命運行時錯誤 (記憶體耗盡等) | ❌ |
| 2 | E_WARNING | 運行時警告 (非致命) | ✅ |
| 4 | E_PARSE | 編譯時語法錯誤 | ❌ |
| 8 | E_NOTICE | 運行時通知 (未定義變數等) | ✅ |
| 16 | E_CORE_ERROR | PHP 啟動致命錯誤 | ❌ |
| 32 | E_CORE_WARNING | PHP 啟動警告 | ❌ |
| 64 | E_COMPILE_ERROR | 編譯致命錯誤 | ❌ |
| 128 | E_COMPILE_WARNING | 編譯警告 | ❌ |
| 256 | E_USER_ERROR | 用戶 trigger_error 產生 | ✅ |
| 512 | E_USER_WARNING | 用戶警告 | ✅ |
| 1024 | E_USER_NOTICE | 用戶通知 | ✅ |
| 2048 | E_STRICT | 程式碼改進建議 | ✅ |
| 4096 | E_RECOVERABLE_ERROR | 可捕獲致命錯誤 (型別錯誤等) | ✅ |
| 8192 | E_DEPRECATED | 棄用功能警告 | ✅ |
| 16384 | E_USER_DEPRECATED | 用戶棄用警告 | ✅ |
| 32767 | E_ALL | 所有錯誤 (PHP 8.0+ 包含 E_STRICT) | - |
設定自定義處理器
<?php
function customErrorHandler(int $level, string $message, string $file, int $line, array $context = []): bool {
// 1. 記錄日誌
$log = sprintf(
"[%s] %s: %s in %s:%d\n",
date('Y-m-d H:i:s'),
getErrorLevelName($level),
$message,
$file, $line
);
error_log($log, 3, __DIR__ . '/logs/errors.log');
// 2. 開發環境顯示
if (ini_get('display_errors')) {
echo "$log
";
}
// 3. 致命錯誤不返回 true (讓內建處理器終止腳本)
if (in_array($level, [E_ERROR, E_PARSE, E_CORE_ERROR, E_CORE_WARNING, E_COMPILE_ERROR, E_COMPILE_WARNING])) {
return false;
}
return true; // 阻止內建處理器
}
function getErrorLevelName(int $level): string {
$levels = [
E_ERROR => 'ERROR', E_WARNING => 'WARNING', E_PARSE => 'PARSE',
E_NOTICE => 'NOTICE', E_CORE_ERROR => 'CORE_ERROR', E_CORE_WARNING => 'CORE_WARNING',
E_COMPILE_ERROR => 'COMPILE_ERROR', E_COMPILE_WARNING => 'COMPILE_WARNING',
E_USER_ERROR => 'USER_ERROR', E_USER_WARNING => 'USER_WARNING', E_USER_NOTICE => 'USER_NOTICE',
E_STRICT => 'STRICT', E_RECOVERABLE_ERROR => 'RECOVERABLE_ERROR', E_DEPRECATED => 'DEPRECATED',
E_USER_DEPRECATED => 'USER_DEPRECATED',
];
return $levels[$level] ?? 'UNKNOWN';
}
set_error_handler('customErrorHandler', E_ALL | E_STRICT);
// 觸發測試
trigger_error("這是用戶警告", E_USER_WARNING);
?>
觸發錯誤 trigger_error()
<?php
// 驗證用戶輸入
$age = $_POST['age'] ?? 0;
if (!is_numeric($age) || $age < 0 || $age > 150) {
trigger_error("無效年齡輸入: $age", E_USER_WARNING);
// 可選:拋出例外代替
// throw new InvalidArgumentException("無效年齡: $age");
}
?>
3. 錯誤日誌記錄 error_log()
<?php
// 發送到系統日誌 (syslog/event log)
error_log("資料庫連線失敗", 0);
// 發送郵件通知管理員
error_log("嚴重錯誤: $message", 1, "admin@example.com", "From: system@example.com");
// 寫入自定義檔案
error_log("除錯資訊: $var", 3, __DIR__ . "/logs/debug.log");
?>
4. 異常處理 (Exception Handling)
基本結構
<?php
try {
// 可能拋出異常的代碼
$result = riskyOperation($input);
} catch (SpecificException $e) {
// 處理特定異常
logger()->error($e->getMessage());
return fallbackResponse();
} catch (Exception $e) {
// 捕獲其他異常
logger()->critical($e->getMessage());
throw $e; // 重新拋出
} finally {
// 清理資源 (一定會執行)
cleanupResources();
}
?>
異常處理規則
try 區塊包含可能拋出異常的代碼
- 每個
throw 至少對應一個 catch
- 多個
catch 可捕獲不同類型異常 (子類別優先)
finally 區塊總是執行 (即使有 return/throw)
- 未捕獲異常 →
set_exception_handler → Fatal Error
自定義異常類別
<?php
class AppException extends Exception {
protected int $code = 500;
public function __construct(string $message = "", int $code = 0, Throwable $previous = null) {
parent::__construct($message, $code ?: $this->code, $previous);
}
}
class ValidationException extends AppException {
protected int $code = 422;
public array $errors = [];
public function __construct(array $errors, string $message = "驗證失敗") {
$this->errors = $errors;
parent::__construct($message);
}
}
class NotFoundException extends AppException {
protected int $code = 404;
}
?>
重新拋出異常 (轉換為用戶友善訊息)
<?php
try {
$user = User::findOrFail($id);
} catch (ModelNotFoundException $e) {
// 系統錯誤 → 用戶友善錯誤
throw new NotFoundException("找不到指定用戶");
} catch (QueryException $e) {
// 記錄詳細錯誤給開發者
logger()->error("DB Error: " . $e->getMessage());
// 回傳通用訊息給用戶
throw new AppException("系統暫時無法處理請求,請稍後再試");
}
?>
5. 錯誤 vs 異常:何時用哪個?
| 特性 | 錯誤 | 異常 |
| 來源 | PHP 核心、擴展、trigger_error | 程式碼主動 throw、第三方庫 |
| 可捕獲 | set_error_handler (部分) | try/catch 完全捕獲 |
| 型別系統 | 整數層級常數 | 類別繼承體系 |
| 堆疊追蹤 | 無 (需 debug_backtrace) | 內建 getTrace() |
| 適用場景 | 非預期系統錯誤、舊代碼相容 | 業務邏輯錯誤、可預期失敗、流程控制 |
現代 PHP 最佳實務 (PHP 7/8+)
- 優先使用異常:業務邏輯錯誤拋出具體異常類別
- 錯誤轉異常:用
ErrorException 將錯誤統一為異常
set_error_handler(function($level, $msg, $file, $line) {
if (error_reporting() & $level) {
throw new ErrorException($msg, 0, $level, $file, $line);
}
});
- 統一錯誤回應:中介層捕獲所有異常,輸出標準 JSON/API 格式
- 結構化日誌:Monolog + JSON 格式,便於 ELK/Splunk 分析
- 不要吞沒異常:
catch (Exception $e) { } 是大忌,至少要 log