PHP 擁有雙重錯誤機制:
E_ERROR, E_WARNING, E_NOTICE 等,非物件,無法 try-catch,需用 set_error_handler、error_get_last 處理。Exception、Error (PHP 7+)、TypeError、ArithmeticError 等,物件導向,支援 try-catch-finally。現代 PHP (7.1+) 建議 統一轉為例外模型,但理解傳統機制對維護舊代碼至關重要。
error_get_last() 陷阱與正確用法error_reporting(0); // 屏蔽所有錯誤輸出
echo 5 / 0; // 觸發 E_WARNING (除零),腳本繼續執行
$arr = error_get_last();
if (isset($arr)) { // 永遠為 true,因 error_get_last() 回傳陣列或 null
echo "出錯了";
print_r($arr);
exit;
}
問題:5/0 只觸發 E_WARNING,不會中止腳本,error_get_last() 確實能取得,但 isset($arr) 永真,邏輯失效。
<?php
// 1. 定義統一例外類別
class PhpErrorException extends ErrorException {
public function __construct($message, $code, $severity, $file, $line) {
parent::__construct($message, $code, $severity, $file, $line);
}
}
// 2. 註冊錯誤處理器:將所有錯誤轉為例外拋出
function errorToException($severity, $message, $file, $line) {
if (!(error_reporting() & $severity)) return; // 尊重 error_reporting 位元組
throw new PhpErrorException($message, 0, $severity, $file, $line);
}
set_error_handler('errorToException');
// 3. 註冊致命錯誤捕獲 (PHP 7+ 可用 Error 例外,此為相容舊版)
register_shutdown_function(function() {
$error = error_get_last();
if ($error && in_array($error['type'], [E_ERROR, E_CORE_ERROR, E_COMPILE_ERROR, E_PARSE])) {
// 記錄日誌、發送告警、顯示友善頁面
logError($error);
include __DIR__ . '/templates/500.php';
}
});
// 4. 業務代碼正常 try-catch
try {
$result = riskyOperation(); // 可能觸發 warning/notice
echo $result;
} catch (PhpErrorException $e) {
// 處理轉換來的 PHP 錯誤
logError(['message' => $e->getMessage(), 'file' => $e->getFile(), 'line' => $e->getLine()]);
showFriendlyMessage('系統暫時不可用,請稍後再試');
} catch (Exception $e) {
// 處理主動拋出的業務例外
logError($e);
showFriendlyMessage('操作失敗:' . $e->getMessage());
}
try {
$val = 5 / 0; // PHP 7+ 拋出 DivisionByZeroError (繼承 ArithmeticError -> Error)
$arr = [];
echo $arr[10]; // 拋出 Error (內部錯誤)
} catch (DivisionByZeroError $e) {
// 專門捕獲除零
} catch (TypeError $e) {
// 類型錯誤
} catch (Error $e) {
// 捕獲所有 Engine 錯誤 (Error 不繼承 Exception)
} catch (Exception $e) {
// 捕獲使用者拋出的例外
} finally {
// 清理資源
}
關鍵點:Error 和 Exception 同屬 Throwable 介面,但 互不繼承,必須分別捕獲或捕獲 Throwable。
ini_set('display_errors', '0'); ini_set('display_startup_errors', '0');ini_set('log_errors', '1'); ini_set('error_log', '/var/log/php/error.log');error_page 500 /500.html,或 PHP register_shutdown_function 渲染模板。zend_test 或自定義處理器過濾。<?php
// 友善錯誤頁面渲染
function renderErrorPage($code = 500, $message = '伺服器內部錯誤') {
http_response_code($code);
if (php_sapi_name() === 'cli') {
echo "[$code] $message\n";
return;
}
// 判斷是否 AJAX/JSON 請求
if (strpos($_SERVER['HTTP_ACCEPT'] ?? '', 'application/json') !== false ||
strpos($_SERVER['HTTP_X_REQUESTED_WITH'] ?? '', 'XMLHttpRequest') !== false) {
header('Content-Type: application/json; charset=utf-8');
echo json_encode(['error' => ['code' => $code, 'message' => $message]]);
return;
}
// HTML 頁面
include __DIR__ . "/errors/{$code}.php";
exit;
}
// 統一日誌格式
function logError(array $context) {
$log = [
'time' => date('c'),
'ip' => $_SERVER['REMOTE_ADDR'] ?? 'cli',
'uri' => $_SERVER['REQUEST_URI'] ?? '',
'method' => $_SERVER['REQUEST_METHOD'] ?? 'CLI',
'trace' => debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 10),
'context' => $context,
];
error_log(json_encode($log, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) . "\n", 3, '/var/log/php/app-error.log');
}
PHP 錯誤處理的核心原則:開發環境顯示詳盡、生產環境記錄完整、用戶看到友善、系統自動告警。採用「錯誤轉例外 + 統一 try-catch + 關機函數兜底」架構,即可同時相容舊代碼與現代框架,構建可觀測、可維運的應用。