萬盛學電腦網

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

PHP 錯誤捕獲與友善提示:從 error_get_last 到 例外處理最佳實踐

前言:PHP 錯誤處理的兩種範式

PHP 擁有雙重錯誤機制:

  1. 傳統錯誤:E_ERROR, E_WARNING, E_NOTICE 等,非物件,無法 try-catch,需用 set_error_handler、error_get_last 處理。
  2. 例外: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());
}

二、PHP 7+ 現代例外體系

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。

三、生產環境錯誤處理清單

  1. 關閉顯示錯誤:ini_set('display_errors', '0'); ini_set('display_startup_errors', '0');
  2. 記錄完整日誌:ini_set('log_errors', '1'); ini_set('error_log', '/var/log/php/error.log');
  3. 自定義錯誤頁面:Nginx/Apache 配置 error_page 500 /500.html,或 PHP register_shutdown_function 渲染模板。
  4. 錯誤分級告警:
    • E_ERROR/E_CORE_ERROR:即時告警 (Slack/Email/PagerDuty)
    • E_WARNING/E_NOTICE:日誌聚合分析 (ELK/Loki)
  5. 敏感資訊過濾:日誌中脫敏密碼、Token、PII,可用 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 + 關機函數兜底」架構,即可同時相容舊代碼與現代框架,構建可觀測、可維運的應用。

copyright © 萬盛學電腦網 all rights reserved