萬盛學電腦網

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

PHP trigger_error 主動觸發錯誤與錯誤抑制符 @ 完整指南

PHP 錯誤處理不僅限於解析器自動拋出,開發者可主動觸發錯誤輔助除錯,亦可用 @ 抑制輸出。本文詳細說明兩者用法與差異。

錯誤抑制符 @

  • 置於任意可能產生錯誤的**運算式**之前
  • 抑制該運算式產生的錯誤訊息輸出
  • 不影響 error_get_last() 取得錯誤資訊
  • 慎用:隱藏真實問題,增加除錯難度
$file = @fopen('not_exist.txt', 'r'); // 不會輸出 warning
if (!$file) {
    $err = error_get_last();
    // 處理錯誤
}

trigger_error:主動觸發使用者層級錯誤

trigger_error(string $message, int $type = E_USER_NOTICE): bool
錯誤類型常數嚴重度行為
E_USER_ERROR致命錯誤腳本終止執行
E_USER_WARNING警告腳本繼續執行
E_USER_NOTICE通知腳本繼續執行
E_USER_DEPRECATED棄用警告腳本繼續執行

實戰範例:參數驗證觸發通知

$num1 = 1;
$num2 = '2a';

if (!(is_numeric($num1) && is_numeric($num2))) {
    trigger_error('num1 和 num2 必須為合法數值', E_USER_NOTICE);
} else {
    echo $num1 + $num2;
}
echo "\n程式繼續向下執行";

輸出:

Notice: num1 和 num2 必須為合法數值 in ... on line 6
程式繼續向下執行

嚴重錯誤場景:資料庫連線失敗

$link = @mysqli_connect($host, $user, $pass, $db);
if (!$link) {
    trigger_error('資料庫連線失敗: ' . mysqli_connect_error(), E_USER_ERROR);
}

使用 E_USER_ERROR 替代內建 E_WARNING,強制腳本終止,避免後續邏輯在無連線狀態下執行。

配合錯誤處理器

set_error_handler(function($severity, $message, $file, $line) {
    if ($severity & (E_USER_ERROR | E_USER_WARNING | E_USER_NOTICE)) {
        error_log("[$severity] $message in $file:$line");
        if ($severity === E_USER_ERROR) exit(1);
    }
    return false; // 繼續標準處理流程
});

最佳實務

  • 驗證失敗、業務規則違反、外部服務異常 → trigger_error + 自訂錯誤處理器
  • 預期可能失敗的 I/O 操作(檔案、網路)→ @ + error_get_last() 檢查
  • 生產環境關閉 display_errors,開啟 log_errors 記錄至檔案/系統日誌
  • 勿用 @ 掩蓋邏輯錯誤,應修正根本原因

善用主動觸發錯誤,能建立可觀測、可控制的錯誤處理體系,提升系統健壯度。

copyright © 萬盛學電腦網 all rights reserved