生產環境通常關閉 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 失敗拋出 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');
__destruct() 在關閉函數之前執行exit() 或 die() 中斷關閉函數善用 register_shutdown_function 可構建「最後防線」,配合結構化日誌與友好錯誤頁,顯著提升系統健壯性與運維效率。