結合mysqli_sql_exception 使用$errno 捕捉詳細異常

M66 2025-05-28

在使用PHP 操作MySQL 數據庫時， mysqli擴展是最常見的數據庫連接工具之一。然而，在數據庫操作過程中，難免會遇到一些異常或錯誤，為了能夠更好地捕捉和處理這些異常， mysqli_sql_exception和mysqli::$errno提供了強大的功能。本文將通過示例說明如何結合mysqli_sql_exception來捕捉詳細的數據庫異常信息，並使用mysqli::$errno進一步處理這些錯誤。

1. 什麼是mysqli_sql_exception ？

mysqli_sql_exception是PHP 中一個專門用於處理MySQL 數據庫異常的類。當執行數據庫查詢時，如果發生錯誤， mysqli_sql_exception會拋出相應的異常。這使得開發者可以通過try...catch語句捕捉並處理這些異常，而不必依賴傳統的錯誤處理方式（如mysqli_error或mysqli_errno ）。

2. mysqli::$errno的作用

在mysqli_sql_exception中， mysqli::$errno記錄了最後一次MySQL 操作的錯誤代碼。它是一個數字，表示數據庫操作錯誤的類型。例如， mysqli::$errno可以幫助我們區分是連接失敗、查詢語法錯誤還是權限問題等。結合mysqli_sql_exception使用，可以更加詳細地捕捉和處理錯誤信息。

3. 捕捉並處理異常的基本流程

使用mysqli_sql_exception捕捉數據庫異常的基本步驟如下：

在創建數據庫連接時開啟異常模式。
使用try...catch語句塊捕捉數據庫操作中的異常。
在catch語句塊中使用mysqli::$errno獲取錯誤代碼，並根據錯誤代碼提供詳細的錯誤信息或處理邏輯。

4. 示例代碼

以下是一個使用mysqli_sql_exception和mysqli::$errno捕捉並處理數據庫異常的完整示例：

 <?php
// 開啟異常處理
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);

// 創建數據庫連接
try {
    $mysqli = new mysqli("localhost", "root", "password", "test_database");

    // 進行數據庫查詢操作
    $result = $mysqli->query("SELECT * FROM non_existing_table");

} catch (mysqli_sql_exception $e) {
    // 捕獲數據庫異常
    echo "數據庫操作失敗: " . $e->getMessage() . "<br>";

    // 輸出錯誤代碼
    echo "錯誤代碼: " . $e->getCode() . "<br>";

    // 進一步處理不同類型的錯誤
    if ($e->getCode() == 1146) { // 1146 表示表不存在
        echo "錯誤：表不存在，請檢查數據庫結構。";
    } else {
        echo "錯誤：無法執行查詢，請檢查您的 SQL 文法。";
    }

    // 也可以使用 mysqli::$errno 獲取具體的 MySQL 錯誤代碼
    echo "MySQL 錯誤代碼: " . $mysqli->errno . "<br>";
    echo "MySQL 錯誤信息: " . $mysqli->error . "<br>";
}
?>

5. 代碼解析

開啟異常報告：
使用mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);語句開啟mysqli_sql_exception異常報告。這使得mysqli在遇到錯誤時會拋出mysqli_sql_exception異常，而不是通過返回錯誤代碼來報告錯誤。
捕獲異常：
通過try...catch語句，我們可以捕獲所有的mysqli_sql_exception異常，並在catch語句塊中進行處理。
獲取錯誤代碼和信息：
通過$e->getCode()可以獲取數據庫異常的錯誤代碼，進一步可以根據錯誤代碼提供不同的錯誤提示信息。
使用mysqli::$errno和mysqli::$error ：
通過$mysqli->errno和$mysqli->error獲取MySQL 數據庫的錯誤代碼和錯誤信息，這對於調試和處理錯誤非常有用。

6. 錯誤處理的優化

在實際開發中，除了捕捉並輸出錯誤信息外，我們還可以根據錯誤類型進行優化處理：

錯誤日誌記錄：將錯誤信息記錄到日誌文件中，方便後續查看和排查。
用戶友好的錯誤提示：根據錯誤類型顯示友好的提示信息，避免向用戶暴露數據庫細節。
事務處理：對於涉及多個查詢的操作，可以使用事務機制來保證數據的一致性和可靠性。

7. 總結

通過結合mysqli_sql_exception和mysqli::$errno ，我們可以在數據庫操作中捕捉並處理詳細的異常信息。這不僅幫助開發者更快地定位問題，還能夠提升系統的健壯性和用戶體驗。希望本文的示例能夠幫助你更好地理解和使用PHP 中的數據庫異常處理機制。