PHP 錯誤處理機制完整指南：從 die() 到自訂處理器與錯誤日誌

完善的錯誤處理是專業 PHP 應用的基石。本文系統介紹三層錯誤處理策略：基礎終止、自訂錯誤處理器、錯誤記錄與通知，並附上生產環境可用的代碼範例。

層級一：基礎錯誤處理 — die()/exit()

簡單腳本可在關鍵操作前檢查條件，失敗即終止：

<?php
if (!file_exists("welcome.txt")) {
    die("File not found");
}
$file = fopen("welcome.txt", "r");
?>

缺點： 直接終止腳本，無法優雅降級、記錄日誌或釋放資源，不適合複雜應用。

層級二：自訂錯誤處理器 — set_error_handler()

錯誤處理函式簽名

function error_handler($errno, $errstr, $errfile = '', $errline = 0, $errcontext = []) {
    // $errno: 錯誤等級 | $errstr: 錯誤訊息
    // $errfile: 檔案 | $errline: 行號 | $errcontext: 當前變數陣列
}

錯誤等級常數

註冊自訂處理器

<?php
function customError($errno, $errstr) {
    echo "<b>Error:</b> [$errno] $errstr<br />";
    echo "Ending Script";
    die();
}

// 處理所有錯誤
set_error_handler("customError");

// 或僅處理特定等級
set_error_handler("customError", E_USER_WARNING | E_USER_ERROR);
?>

主動觸發錯誤 — trigger_error()

<?php
$test = 2;
if ($test > 1) {
    trigger_error("Value must be 1 or below", E_USER_WARNING);
}
?>

輸出：Error: [512] Value must be 1 or below

層級三：錯誤記錄與通知 — error_log()

寫入系統日誌（預設 php.ini error_log）

error_log("Database connection failed: $errstr", 0);

發送 Email 通知關鍵錯誤

<?php
function customError($errno, $errstr) {
    echo "<b>Error:</b> [$errno] $errstr<br />";
    echo "Webmaster has been notified";
    // 類型 1: 發送 Email
    error_log("Error: [$errno] $errstr", 1, "admin@example.com", "From: webmaster@example.com");
}

set_error_handler("customError", E_USER_WARNING);
$test = 2;
if ($test > 1) {
    trigger_error("Value must be 1 or below", E_USER_WARNING);
}
?>

寫入自訂檔案

error_log("Error: [$errno] $errstr\n", 3, "/var/log/php_app_errors.log");

生產環境最佳實踐建議

1. 區分環境： 開發環境 display_errors=On、error_reporting=E_ALL；生產環境 display_errors=Off、log_errors=On
2. 例外處理優先： PHP 5+ 應優先使用 try-catch 與 set_exception_handler()，錯誤處理器僅處理無法拋出例外的舊式錯誤
3. 統一日誌格式： JSON 結構化日誌，含 timestamp、level、message、context、trace_id，便於 ELK/Logstash 分析
4. 錯誤分級通知： E_USER_ERROR/E_RECOVERABLE_ERROR 立即發送告警（Email/Slack/PagerDuty），WARNING 定期匯總，NOTICE 僅記錄
5. 避免資訊洩露： 生產環境絕不直接輸出堆疊追蹤、SQL 語句、環境變數給使用者
6. 關鍵資源釋放： 使用 register_shutdown_function() 或 finally 區塊確保連線、鎖、暫存檔正確釋放

現代框架整合

• Laravel：App\Exceptions\Handler 統一處理、report() 回報、render() 渲染
• Symfony：Kernel::terminate()、Monolog 整合
• CodeIgniter：log_message()、show_error()

從 die() 到結構化日誌與告警體系，錯誤處理的演進反映了應用成熟度。建立統一、可觀測、可運維的錯誤處理機制，是從「能跑」到「穩定上線」的關鍵一步。