萬盛學電腦網

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

PHP register_shutdown_function 捕獲致命錯誤實戰指南

痛點場景

生產環境通常關閉 display_errors,一旦發生 Fatal Error(如類未定義、引入不存在文件),用戶將面對空白頁面,既影響體驗,又無法獲取錯誤信息排查問題。

核心機制

register_shutdown_function() 註冊的回調函數會在腳本執行結束(正常結束或因致命錯誤終止)前自動調用。這是 PHP 僅有的幾種能「捕獲」 Fatal Error 的機制之一。

完整實現代碼

<?php
$flag = false;

function deal_error() {
    global $flag;
    if (!$flag) {
        // 這裡可以記錄日誌、發送郵件告警、返回友好錯誤頁面
        error_log('[FATAL] Script terminated unexpectedly: ' . json_encode(debug_backtrace()));
        header('Content-Type: text/html; charset=utf-8');
        echo '<div style="padding:20px;text-align:center;color:#d32f2f;">';
        echo '<h2>系統暫時不可用,請稍後重試</h2>';
        echo '<p>錯誤已自動記錄,技術團隊正在處理中...</p>';
        echo '</div>';
    }
    return false;
}

register_shutdown_function('deal_error');

// 業務邏輯開始
require('./test.php'); // 若文件不存在將觸發 Fatal Error
// $obj = new NotExistClass(); // 實例化不存在的類也會觸發

$flag = true; // 正常執行到此處,標記成功
?>

關鍵點解析

  • 旗標變量:利用全局變量 $flag 區分正常結束與異常終止
  • require vs include:require 失敗拋出 Fatal Error,include 僅警告繼續執行
  • 無法捕獲的情況:語法解析錯誤(缺少分號、括號不匹配)發生在編譯階段,無法被捕獲

進階應用:結合錯誤日誌系統

function shutdown_handler() {
    $error = error_get_last();
    if ($error && in_array($error['type'], [E_ERROR, E_CORE_ERROR, E_COMPILE_ERROR, E_PARSE])) {
        // 結構化日誌記錄
        $log = [
            'timestamp' => date('c'),
            'error' => $error,
            'request' => [
                'uri' => $_SERVER['REQUEST_URI'] ?? '',
                'method' => $_SERVER['REQUEST_METHOD'] ?? '',
                'ip' => $_SERVER['REMOTE_ADDR'] ?? ''
            ],
            'trace' => debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS)
        ];
        error_log(json_encode($log, JSON_UNESCAPED_UNICODE), 3, '/var/log/php_fatal.log');
        
        // 用戶友好提示(非 AJAX 請求)
        if (empty($_SERVER['HTTP_X_REQUESTED_WITH'])) {
            http_response_code(500);
            include __DIR__ . '/templates/500.php';
        }
    }
}
register_shutdown_function('shutdown_handler');

注意事項

  1. 關閉函數執行時,已經無法輸出 HTTP Header(若前面有輸出)
  2. 對象析構函數 __destruct() 在關閉函數之前執行
  3. 無法使用 exit() 或 die() 中斷關閉函數
  4. 建議在框架入口文件最早處註冊,確保覆蓋所有後續代碼

總結

善用 register_shutdown_function 可構建「最後防線」,配合結構化日誌與友好錯誤頁,顯著提升系統健壯性與運維效率。

copyright © 萬盛學電腦網 all rights reserved