用next_result() 實現多查詢返回分頁邏輯

gitbox 2025-05-02

在使用PHP 進行數據庫操作時，我們有時需要執行多個查詢，並處理這些查詢的結果。對於一些複雜的查詢，我們可能需要使用多查詢返回的分頁邏輯。 next_result()函數在這類場景中非常有用。它能幫助我們有效地處理多個查詢的結果，尤其是在需要分頁的情況下。

什麼是next_result()函數？

next_result()是PHP 的mysqli擴展中的一個函數。它允許我們在執行多個查詢時，逐個地獲取每個查詢的結果。當你使用mysqli_multi_query()函數執行多個查詢時， next_result()就可以讓你循環處理每個查詢的結果。

通常， mysqli_multi_query()用於執行多個SQL 查詢，而next_result()使我們能夠逐一獲取每個查詢的結果，並在每次迭代中處理數據。

使用場景

我們在處理多個查詢結果時，可能需要分頁功能。比如，當有多個分頁查詢結果時，我們需要依次獲取並顯示每個查詢的結果。這時， next_result()就能幫助我們有效地跳轉到下一個查詢的結果集，並且避免了混淆和重複處理。

示例代碼

假設我們有一個數據庫，其中包含了多個分頁查詢結果，我們可以使用以下代碼來實現分頁：

 <?php
// 數據庫連接
$mysqli = new mysqli("localhost", "username", "password", "database");

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

// 執行多個查詢
$query = "SELECT * FROM table1 LIMIT 10; 
          SELECT * FROM table2 LIMIT 10; 
          SELECT * FROM table3 LIMIT 10;";

if ($mysqli->multi_query($query)) {
    do {
        // 獲取結果集
        if ($result = $mysqli->store_result()) {
            // 循環輸出結果
            while ($row = $result->fetch_assoc()) {
                echo "ID: " . $row['id'] . " - Name: " . $row['name'] . "<br>";
            }
            // 釋放結果集
            $result->free();
        }
        
        // 獲取下一個結果集
    } while ($mysqli->next_result());
}

// 关闭數據庫連接
$mysqli->close();
?>

解析代碼

數據庫連接：首先，我們通過new mysqli()創建了一個數據庫連接對象$mysqli ，並連接到本地數據庫。
多查詢執行：使用multi_query()函數執行多個查詢，這裡我們執行了三個查詢，每個查詢都使用LIMIT 10限制結果集為10 條記錄。
處理每個結果集：通過store_result()獲取每個查詢的結果集，然後使用fetch_assoc()逐條輸出結果。
使用next_result() ：在每次查詢結果處理完後，調用next_result()來跳轉到下一個查詢結果集。
關閉數據庫連接：操作完成後，關閉數據庫連接。

如何實現分頁

如果要在多個查詢的結果上實現分頁邏輯，我們可以在next_result()之後處理每個查詢的結果。例如，每次查詢返回10 條記錄，可以按頁展示數據，類似以下代碼：

 <?php
$perPage = 10; // 每頁記錄數
$currentPage = isset($_GET['page']) ? (int)$_GET['page'] : 1;
$offset = ($currentPage - 1) * $perPage;

// 數據庫連接
$mysqli = new mysqli("localhost", "username", "password", "database");

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

// 執行分頁查詢
$query = "SELECT * FROM table1 LIMIT $offset, $perPage;
          SELECT * FROM table2 LIMIT $offset, $perPage;
          SELECT * FROM table3 LIMIT $offset, $perPage;";

if ($mysqli->multi_query($query)) {
    do {
        // 獲取結果集
        if ($result = $mysqli->store_result()) {
            // 循環輸出結果
            while ($row = $result->fetch_assoc()) {
                echo "ID: " . $row['id'] . " - Name: " . $row['name'] . "<br>";
            }
            // 釋放結果集
            $result->free();
        }
        
        // 獲取下一個結果集
    } while ($mysqli->next_result());
}

// 关闭數據庫連接
$mysqli->close();
?>

在這個示例中，我們動態計算了offset ，根據當前頁數調整查詢條件，實現分頁功能。

注意事項

查詢順序：當你使用next_result()時，查詢的順序是非常重要的。確保你按照正確的順序處理每個查詢的結果。
資源管理：每次查詢結果處理完畢後，記得調用free()來釋放資源。
性能考慮：使用multi_query()執行多個查詢時，如果數據量較大，可能會對性能造成影響。要確保合理使用分頁，避免一次性查詢過多數據。

結語

通過next_result()函數，我們可以很方便地實現對多個查詢結果的分頁處理。這對於需要執行多次數據庫查詢，並且對每個查詢結果進行分頁顯示的場景非常適用。希望本文提供的示例代碼能幫助你更好地理解和應用這一函數。