中文(繁體)
中文(繁體)
在PHP 與MySQL 的交互過程中，開發者常常會接觸到multi_query()和next_result()這兩個函數。但不少初學者在閱讀文檔或嘗試實際開發時，容易混淆這兩個函數的用途，甚至誤以為next_result()可以單獨用於執行多條SQL 語句。
本文將深入探討這兩個函數在PHP 中的職責、工作機制、使用方式，以及為什麼next_result()無法替代multi_query() 。
multi_query()是PHP mysqli擴展中的一個函數，它的作用是一次性執行多條SQL 語句。這些SQL 語句必須使用分號( ; ) 分隔，構成一個長的SQL 字符串。
$mysqli = new mysqli("localhost", "user", "password", "database");
$sql = "SELECT * FROM users; SELECT * FROM orders;";
if ($mysqli->multi_query($sql)) {
do {
if ($result = $mysqli->store_result()) {
while ($row = $result->fetch_assoc()) {
print_r($row);
}
$result->free();
}
} while ($mysqli->next_result());
} else {
echo "執行失敗: " . $mysqli->error;
}
在這個示例中， multi_query()啟動了一個多結果集的處理流程，而後通過next_result()來依次訪問每一條語句的結果。
next_result()的職責是讓mysqli 向下一個結果集推進。它不會執行任何SQL，而只是從已經由multi_query()執行後的結果中，向下一個語句的返回結果移動。
也就是說， next_result()本身不執行SQL，它只是遍歷。
如果沒有multi_query()的前置調用， next_result()根本無事可做。它依賴的上下文是“已經執行了多條語句”。
這就像問「為什麼不能用遙控器來打開電視，而不插電源？」因為next_result()是處理流程的一部分，而不是執行動作的起點。
職責不同
multi_query()是執行器。
next_result()是迭代器。
依賴關係
沒有multi_query()的上下文，調用next_result()會返回false 。
next_result()只在multi_query()成功執行後才有意義。
錯誤處理與狀態管理
multi_query()負責執行和初始化所有語句，出現錯誤可立即中斷。
next_result()則是處理結果集，它不會重試或重新執行SQL。
場景：執行多條初始化語句，例如建表與插入數據
$sql = "
CREATE TABLE IF NOT EXISTS logs (id INT AUTO_INCREMENT PRIMARY KEY, message TEXT);
INSERT INTO logs (message) VALUES ('初始化成功');
SELECT * FROM logs;
";
$mysqli = new mysqli("localhost", "user", "password", "database");
if ($mysqli->multi_query($sql)) {
do {
if ($result = $mysqli->store_result()) {
while ($row = $result->fetch_assoc()) {
echo $row['message'] . "\n";
}
$result->free();
}
} while ($mysqli->next_result());
} else {
echo "執行出錯: " . $mysqli->error;
}
你可以把這個應用在如部署腳本、批量初始化數據等場景中。
在PHP 的數據庫編程中， multi_query()和next_result()是配套使用的一對工具。前者負責將多條語句送入數據庫執行，後者負責取出每一條語句的執行結果。
試圖用next_result()來執行SQL 語句，等同於“只用遙控器開電視但沒有插電”，它是無法獨立完成任務的。只有充分理解它們各自的職責和上下文，才能寫出高效、穩定的數據庫交互代碼。
如果你還在使用REST 接口測試多語句執行，例如向https://gitbox.net/api/sql-exec提交多條語句，也應記得使用支持多語句的執行方式來模擬multi_query()的效果。
