如何使用next_result() 讀取存儲過程的輸出參數

在使用PHP 操作MySQL 數據庫時，調用存儲過程是一種常見的做法，尤其當我們希望將復雜的業務邏輯封裝在數據庫層面時。然而，很多開發者在調用帶有**輸出參數（OUT 參數）**的存儲過程時，往往會遇到讀取不到輸出參數值的情況。

其中一個關鍵點就在於next_result()的使用。本文將詳細解釋為何需要調用該函數，以及如何正確讀取存儲過程的輸出參數。

一、什麼是next_result() ？

當使用mysqli驅動調用一個返回多個結果集（如多個SELECT或同時包含SELECT和輸出參數）的存儲過程時，MySQL 會以“多個結果集”的方式返回數據。 next_result()方法用於讓mysqli驅動準備讀取下一個結果集。

如果不顯式調用next_result()並遍歷完所有結果集，某些數據庫結果（如輸出參數或最終的結果集）將無法被訪問。

二、存儲過程示例

我們先來看一個簡單的MySQL 存儲過程，它有一個輸入參數和一個輸出參數：

 DELIMITER $$

CREATE PROCEDURE get_user_email(IN user_id INT, OUT email VARCHAR(255))
BEGIN
    SELECT user_email INTO email FROM users WHERE id = user_id;
END $$

DELIMITER ;

這個存儲過程根據用戶ID 查詢其郵箱，並通過OUT 參數返回。

三、PHP 調用該存儲過程

<?php
$mysqli = new mysqli("localhost", "username", "password", "your_database");

// 檢查連接
if ($mysqli->connect_error) {
    die("連接失敗: " . $mysqli->connect_error);
}

// 1. 設定 OUT 參數變量
$mysqli->query("SET @email = ''");

// 2. 調用存儲過程
$mysqli->query("CALL get_user_email(1, @email)");

// 3. 必須使用 next_result() 清除結果集
while ($mysqli->more_results()) {
    $mysqli->next_result();
    $result = $mysqli->store_result();
    if ($result) {
        $result->free();
    }
}

// 4. 獲取 OUT 參數
$result = $mysqli->query("SELECT @email AS user_email");
$row = $result->fetch_assoc();

echo "用戶郵箱為: " . $row['user_email'];

$mysqli->close();
?>

四、為什麼next_result()是關鍵？

在調用CALL語句後，MySQL 實際上可能返回一個或多個隱式結果集。如果不使用next_result()來清除這些結果集，後續的查詢（如SELECT @email ）可能會被阻塞或者執行失敗。

有些開發者會遇到“讀取輸出參數為空”的問題，其實並不是存儲過程沒執行成功，而是前面的結果集沒有清除，導致後面的查詢根本沒執行。

五、進階：使用預處理語句

如果你使用的是預處理語句，也可以使用類似邏輯：

 $stmt = $mysqli->prepare("CALL get_user_email(?, @email)");
$stmt->bind_param("i", $userId);
$userId = 1;
$stmt->execute();

// 清理所有結果集
do {
    if ($result = $stmt->get_result()) {
        $result->free();
    }
} while ($stmt->more_results() && $stmt->next_result());

// 獲取输出參數
$result = $mysqli->query("SELECT @email AS user_email");
$row = $result->fetch_assoc();
echo "用戶郵箱為: " . $row['user_email'];

六、總結

當你使用CALL執行存儲過程時，無論是否使用輸出參數或返回多個結果集，你都應該調用next_result()來遍歷所有潛在的結果集。

這不僅是良好的實踐，更是確保你可以正確讀取OUT 參數的前提條件。牢記這一點，能夠幫助你避免很多讓人頭疼的“結果讀取不到”的問題。

有關更多存儲過程調用的最佳實踐，你可以訪問我們的開髮指南： https://gitbox.net/docs/mysql/stored-procedures