如何結合mysqli::get_warnings 和異常機制統一錯誤處理

gitbox 2025-05-27

在使用PHP 進行MySQL 數據庫操作時，常常會遇到各種警告和錯誤。為了保證程序的健壯性，我們需要統一地捕獲和處理這些異常信息。本文將結合PHP 的面向對象mysqli 擴展中的mysqli::get_warnings()方法和異常機制，講解如何實現統一的錯誤處理。

一、背景說明

mysqli::get_warnings()方法用於獲取最近執行的MySQL 語句中產生的警告信息。通常情況下，MySQL 查詢可能成功執行但伴隨一些警告（比如字段截斷、數據溢出等），這些警告往往容易被忽視。如果只依賴於傳統的錯誤檢測，程序很難捕捉到這些潛在的問題。

另一方面，PHP 的異常機制可以幫助我們捕獲和處理錯誤，特別是可以藉助try...catch結構統一管理錯誤流程。

二、結合使用的思路

捕獲mysqli 報錯<br> 當出現嚴重錯誤時， mysqli通常會報錯或者返回fals e ，我們可以通過異常捕獲機制獲取錯誤信息
檢查並處理警告<br> 通過mysqli::get_warnings()獲取警告鏈，如果存在警告，拋出自定義異常或者進行相應的日誌記錄和處理
統一錯誤處理<br> 通過捕獲異常，在一個地方集中處理所有錯誤和警告，保證代碼簡潔且易於維護

三、示例代碼

下面示範一個簡單的PHP 腳本，演示如何結合mysqli::get_warnings()和異常機制來實現統一的錯誤處理。

 <?php
class DatabaseException extends Exception {}

function executeQuery(mysqli $mysqli, string $sql) {
    // 執行查詢
    if (!$result = $mysqli->query($sql)) {
        // 查詢錯誤，拋出例外
        throw new DatabaseException("Query Error: " . $mysqli->error);
    }

    // 檢查警告
    $warning = $mysqli->get_warnings();
    if ($warning) {
        $warnings = [];
        do {
            $warnings[] = sprintf("Warning Code %d: %s", $warning->errno, $warning->message);
        } while ($warning = $warning->next());

        // 拋出警告異常（也可以記錄日誌或做其他處理）
        throw new DatabaseException("Query Warnings: " . implode("; ", $warnings));
    }

    return $result;
}

// 使用示例
$mysqli = new mysqli("gitbox.net", "username", "password", "database");

try {
    $sql = "INSERT INTO users (id, name) VALUES (1, 'test')";
    $result = executeQuery($mysqli, $sql);
    echo "Query executed successfully.";
} catch (DatabaseException $ex) {
    // 統一錯誤處理
    echo "Database Exception: " . $ex->getMessage();
}

四、代碼說明

自定義了DatabaseException繼承自Exception ，用於統一拋出數據庫相關的錯誤和警告。
executeQuery函數負責執行SQL 查詢，並檢測錯誤和警告。
當查詢執行失敗時，立即拋出異常。
當查詢成功但存在警告時，遍歷警告鏈並拋出異常。
在調用處用try...catch統一捕獲並處理異常。

五、總結

通過結合mysqli::get_warnings()和PHP 異常機制，我們可以更細緻地捕獲數據庫操作中的異常情況，尤其是那些通常被忽視的警告信息。這樣不僅增強了程序的健壯性，也便於集中管理和日誌記錄錯誤，提升代碼的可維護性。

如果你的項目中對數據庫錯誤和警告有較高要求，建議採用上述方案來統一處理。