mysqli::multi_query 配合$errno 處理多語句執行錯誤

M66 2025-05-28

在PHP 中，當我們使用MySQL 數據庫時， mysqli擴展提供了豐富的功能來處理數據庫操作。特別是在處理多個SQL 語句的執行時， mysqli::multi_query方法和mysqli::$errno屬性是非常重要的工具。本篇文章將詳細介紹如何利用這兩者來有效地處理在多語句執行中可能出現的錯誤。

一、什麼是mysqli::multi_query和mysqli::$errno ？

mysqli::multi_query ：
multi_query是mysqli類中的一個方法，用於執行一個包含多個SQL 語句的查詢。它可以一次性執行多個語句並返回結果。通常，我們在執行多個查詢時使用它，特別是在涉及到事務或者批量插入的操作時。
```
 $mysqli->multi_query("SQL語句1; SQL語句2; SQL語句3;");
```
mysqli::$errno ：
errno屬性表示上一個MySQL 操作產生的錯誤代碼。如果執行SQL 查詢時發生錯誤，我們可以通過$mysqli->errno來獲取錯誤代碼。通過該屬性，我們可以方便地檢查是否發生了錯誤，並採取相應的處理措施。
```
 if ($mysqli->errno) {
    echo "錯誤碼: " . $mysqli->errno;
}
```

二、如何處理多語句執行中的錯誤？

當使用mysqli::multi_query執行多個SQL 語句時，如果某一語句執行失敗，我們可以通過mysqli::$errno獲取錯誤信息，從而做出相應的處理。下面通過一個示例來講解如何使用它們。

示例代碼：

 <?php
// 創建 MySQLi 連接
$mysqli = new mysqli("localhost", "root", "password", "database");

// 检查連接是否成功
if ($mysqli->connect_error) {
    die("連接失败: " . $mysqli->connect_error);
}

// 多個 SQL 語句
$sql = "
    INSERT INTO users (username, email) VALUES ('user1', 'user1@example.com');
    INSERT INTO users (username, email) VALUES ('user2', 'user2@example.com');
    INSERT INTO users (username, email) VALUES ('user3', 'user3@example.com');
";

// 执行多個 SQL 語句
if ($mysqli->multi_query($sql)) {
    do {
        // 獲取當前查詢的結果集
        if ($result = $mysqli->store_result()) {
            // 處理查詢結果
            while ($row = $result->fetch_row()) {
                printf("%s\n", $row[0]);
            }
            $result->free();
        }
        // 檢查是否還有更多結果集
    } while ($mysqli->next_result());
    
    // 檢查是否有錯誤
    if ($mysqli->errno) {
        echo "執行錯誤: " . $mysqli->error;
    } else {
        echo "所有語句执行成功！";
    }
} else {
    // 如果多語句查询失败，輸出錯誤信息
    echo "執行失敗: " . $mysqli->error;
}

$mysqli->close();
?>

解釋：

multi_query的執行：
代碼中，我們用mysqli::multi_query方法來執行多個SQL 語句。如果執行成功，它會返回true ，否則返回false 。
處理多個結果集：
multi_query執行後，我們需要通過mysqli::next_result來檢查是否有更多的結果集，並通過mysqli::store_result獲取當前查詢的結果。我們可以逐個處理每個結果集。
錯誤處理：
在多語句執行完成後，我們可以通過mysqli::$errno來檢查是否發生了錯誤。如果發生了錯誤，可以通過mysqli::error獲取詳細的錯誤信息並進行處理。
關閉連接：
在所有操作完成後，記得關閉數據庫連接。

三、總結

mysqli::multi_query是一個強大的方法，可以用來執行多個SQL 語句。
使用mysqli::$errno可以幫助我們在執行多語句時捕獲並處理錯誤。
處理多語句查詢時，我們要確保每個結果集都得到正確的處理，並且及時檢查是否有錯誤發生。

通過這兩者的配合使用，我們可以在多語句執行中更加高效地捕捉和處理可能出現的各種錯誤，從而提升代碼的穩定性和可靠性。