PHP 自定義錯誤處理機制：從 die() 到專業級異常管理

基礎錯誤處理演進

階段 1：die() 硬編碼

if (!file_exists('welcome.txt')) {
    die('File not found');
}
$file = fopen('welcome.txt', 'r');

優點：簡單直接；缺點：終止腳本、無法統一管理、用戶體驗差。

階段 2：自定義錯誤處理器

function myErrorHandler($errno, $errstr, $errfile, $errline) {
    if (!(error_reporting() & $errno)) return; // 尊重 error_reporting 級別
    
    switch ($errno) {
        case E_USER_ERROR:
            echo "<b>My ERROR</b> [$errno] $errstr<br/>";
            echo "錯誤行：$errline 在文件：$errfile中<br/>";
            echo " PHP版本：" . PHP_VERSION . " (" . PHP_OS . ")<br/>";
            break;
        case E_USER_WARNING:
            echo "<b>My WARNING</b> [$errno] $errstr<br/>";
            break;
        case E_USER_NOTICE:
            echo "<b>My NOTICE</b> [$errno] $errstr<br/>";
            break;
        default:
            echo "Unknown error type: [$errno] $errstr<br/>";
    }
    return true; // 防止 PHP 內置處理器繼續執行
}

// 註冊處理器
set_error_handler('myErrorHandler');

// 主動觸發錯誤測試
function trigger_test($age) {
    if ($age <= 0 || $age > 999) trigger_error("年齡不合法：$age歲", E_USER_ERROR);
    if ($age < 18) trigger_error("未成年：$age歲", E_USER_WARNING);
    if ($age > 40 && $age < 100) trigger_error("年齡稍大：$age歲", E_USER_NOTICE);
}

trigger_test(1000); // 拋出 E_USER_ERROR

階段 3：按級別分發處理器（進階）

function myError($errno, $errstr, $errfile, $errline) {
    print_r(func_get_args());
    // 記錄到日誌、發送告警、寫入數據庫...
}

function myWarning($errno, $errstr, $errfile, $errline) {
    print_r(func_get_args());
}

function myNotice($errno, $errstr, $errfile, $errline) {
    print_r(func_get_args());
}

// 註冊：注意 set_exception_handler 用於異常，錯誤用 set_error_handler
set_error_handler('myError', E_USER_ERROR);
set_error_handler('myWarning', E_USER_WARNING);
set_error_handler('myNotice', E_USER_NOTICE);

trigger_error('故意拋出嚴重錯誤！', E_USER_ERROR);

錯誤報告級別詳解

生產環境最佳實踐

1. 開發環境：error_reporting = E_ALL，display_errors = On
2. 生產環境：
   • display_errors = Off
   • log_errors = On
   • error_log = /var/log/php_error.log
   • error_reporting = E_ERROR | E_WARNING | E_PARSE
3. 自定義處理器：記錄完整上下文（請求參數、用戶、堆棧）、分級告警（ERROR 即時通知、WARNING 定時報表）、友好錯誤頁面
4. 異常處理：面向對象代碼優先使用 try-catch + set_exception_handler()，錯誤與異常分離處理

總結

專業的錯誤處理不僅是「不報錯給用戶看」，更是「記錄全、分級準、響應快、恢復強」。從 die() 到分級處理器，再到結合日誌系統與監控告警的異常管理體系，是 PHP 應用工程化的必經之路。