在 PHP 開發中,錯誤處理是保障應用安全與用戶體驗的關鍵環節。set_error_handler() 函數允許開發者定義自訂的錯誤處理邏輯,取代預設的錯誤輸出機制。本文將系統介紹該函數的語法、常見應用場景,並提供完整的代碼示例,幫助你在生產環境中構建更健壯的錯誤處理體系。
預設情況下,PHP 會將錯誤訊息(包含檔案路徑、行號、堆疊追蹤等)直接輸出到瀏覽器。這不僅會洩露伺服器敏感資訊,還會讓用戶看到難以理解的技術錯誤,嚴重影響體驗。透過 set_error_handler(),你可以:
mixed set_error_handler ( callable $error_handler [, int $error_types = E_ALL | E_STRICT ] )
$error_handler:回呼函數,接受 ($errno, $errstr, $errfile, $errline, $errcontext) 五個參數。$error_types:要處理的錯誤等級位元遮罩,預設為 E_ALL | E_STRICT。函數會返回先前的錯誤處理器(若無則為 NULL),失敗時返回 NULL。
<?php
function myErrorHandler($errno, $errstr, $errfile, $errline) {
// 僅在非管理員模式下過濾路徑
if (!defined('IS_ADMIN') || !IS_ADMIN) {
$basePath = getcwd();
$errfile = str_replace($basePath, '', $errfile);
$errstr = str_replace($basePath, '', $errstr);
}
switch ($errno) {
case E_ERROR:
case E_USER_ERROR:
echo "<b>系統錯誤</b> [$errno] $errstr <br>";
echo "發生於 $errfile 第 $errline 行<br>";
echo "程式已終止,請聯繫管理員。";
exit(1);
case E_WARNING:
case E_USER_WARNING:
echo "<b>警告</b> [$errno] $errstr <br>";
break;
case E_NOTICE:
case E_USER_NOTICE:
// 生產環境通常不顯示 Notice
break;
default:
echo "未知錯誤類型: [$errno] $errstr <br>";
}
return true; // 告訴 PHP 錯誤已被處理,不再執行內建處理器
}
// 註冊處理器
set_error_handler('myErrorHandler');
// 測試觸發錯誤
trigger_error('這是一個測試警告', E_USER_WARNING);
?>
register_shutdown_function 捕捉致命錯誤set_error_handler 無法捕捉 E_ERROR、E_PARSE 等致命錯誤。搭配關閉函數可實現全方位捕獲:
<?php
error_reporting(0); // 關閉預設顯示
register_shutdown_function('fatalErrorHandler');
set_error_handler('customErrorHandler');
function fatalErrorHandler() {
$error = error_get_last();
if ($error !== null) {
// 將致命錯誤轉為用戶錯誤,交由 customErrorHandler 處理
switch ($error['type']) {
case E_ERROR:
case E_CORE_ERROR:
case E_COMPILE_ERROR:
trigger_error('Fatal Error: ' . $error['message'], E_USER_ERROR);
break;
case E_WARNING:
trigger_error('Warning: ' . $error['message'], E_USER_WARNING);
break;
default:
trigger_error('Other: ' . $error['message'], E_USER_NOTICE);
}
}
}
function customErrorHandler($errno, $errstr, $errfile, $errline) {
// 統一格式輸出或記錄日誌
$log = date('Y-m-d H:i:s') . " [$errno] $errstr in $errfile:$errline\n";
file_put_contents(__DIR__ . '/error.log', $log, FILE_APPEND);
if (defined('IS_ADMIN') && IS_ADMIN) {
echo "<pre>$log</pre>";
} else {
echo '<div class="error">系統繁忙,請稍後再試。</div>';
}
return true;
}
?>
<?php
class ErrorHandler {
public function handle($errno, $errstr, $errfile, $errline) {
// 實例方法需搭配陣列語法註冊
// set_error_handler([$this, 'handle']);
}
public static function staticHandle($errno, $errstr, $errfile, $errline) {
// 靜態方法可直接使用字串
// set_error_handler('ErrorHandler::staticHandle');
}
}
?>
php.ini 設定 display_errors = Off,僅透過自定義處理器控制輸出。error.log、warning.log),並定期輪轉。true 代表錯誤已處理,若需 PHP 繼續執行內建流程(如發送郵件),請回傳 false。set_error_handler() 是 PHP 錯誤處理的核心工具。善用它能有效隔離開發與生產環境的錯誤顯示策略,提升應用安全性與用戶體驗。結合 register_shutdown_function 與日誌系統,可構建完整的錯誤監控體系。