當前位置: 首頁> 最新文章列表> 通過PDOStatement::rowCount 實現動態分頁查詢

通過PDOStatement::rowCount 實現動態分頁查詢

gitbox 2025-05-19

在PHP 中，分頁是一個常見的需求，尤其是在處理大量數據時。分頁能夠有效地提高應用的性能和用戶體驗。通過數據庫進行分頁查詢，我們通常使用LIMIT和OFFSET子句來限制查詢結果的數量。但是，如何實現一個動態分頁查詢功能呢？這裡，我們將介紹如何使用PDOStatement::rowCount()方法來實現動態分頁。

1. 什麼是PDOStatement::rowCount？

PDOStatement::rowCount()方法是用於獲取最近一次SQL 執行操作影響的行數。這個方法可以用於檢索SQL 查詢（特別是SELECT語句）返回的行數，它對實現分頁非常有幫助，因為我們可以通過知道查詢結果總行數來計算出分頁信息。

不過，需要注意的是，並不是所有的數據庫和查詢都支持rowCount()方法。對於某些類型的查詢（如SELECT ），這個方法的行為可能會有所不同。

2. 分頁查詢的基本思路

分頁查詢通常依賴於兩個信息：

  • 總記錄數：數據庫中總共有多少條記錄。

  • 當前頁數據：根據當前頁數和每頁顯示的記錄數來查詢相應的數據。

我們將通過以下步驟來實現一個動態分頁查詢功能：

  1. 先進行一次查詢來獲取所有記錄的總數（使用COUNT ）。

  2. 使用LIMIT和OFFSET子句來獲取當前頁的數據。

  3. 計算總頁數，並生成分頁導航鏈接。

3. 實現代碼示例

下面的示例代碼演示瞭如何通過PDOStatement::rowCount()方法來實現動態分頁查詢功能：

 <?php
// 連接數據庫
$dsn = 'mysql:host=localhost;dbname=your_database';
$username = 'your_username';
$password = 'your_password';
$options = [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
];

// 創建 PDO 實例
try {
    $pdo = new PDO($dsn, $username, $password, $options);
} catch (PDOException $e) {
    echo '連接失敗: ' . $e->getMessage();
    exit;
}

// 設置每頁顯示的記錄數
$recordsPerPage = 10;

// 獲取當前頁數，默認為1。一頁
$page = isset($_GET['page']) ? (int)$_GET['page'] : 1;
if ($page < 1) $page = 1;

// 計算查詢的偏移量
$offset = ($page - 1) * $recordsPerPage;

// 獲取總記錄數
$sqlCount = 'SELECT COUNT(*) FROM your_table';
$stmtCount = $pdo->query($sqlCount);
$totalRecords = $stmtCount->fetchColumn();

// 使用 LIMIT 和 OFFSET 查詢當前頁數據
$sql = 'SELECT * FROM your_table LIMIT :limit OFFSET :offset';
$stmt = $pdo->prepare($sql);
$stmt->bindParam(':limit', $recordsPerPage, PDO::PARAM_INT);
$stmt->bindParam(':offset', $offset, PDO::PARAM_INT);
$stmt->execute();

// 獲取查詢結果
$rows = $stmt->fetchAll();

// 計算總頁數
$totalPages = ceil($totalRecords / $recordsPerPage);

// 輸出當前頁數據
echo "<h2>1。 $page 頁的數據：</h2>";
foreach ($rows as $row) {
    echo '<pre>';
    print_r($row);
    echo '</pre>';
}

// 顯示分頁導航
echo '<div>';
if ($page > 1) {
    echo '<a href="http://gitbox.net/your_page.php?page=' . ($page - 1) . '">上一頁</a> ';
}
if ($page < $totalPages) {
    echo '<a href="http://gitbox.net/your_page.php?page=' . ($page + 1) . '">下一頁</a>';
}
echo '</div>';
?>

4. 代碼說明

  1. 數據庫連接：我們使用PDO 連接到MySQL 數據庫，並設置了必要的錯誤處理選項。

  2. 總記錄數：首先通過SELECT COUNT(*)獲取數據庫中的總記錄數， $totalRecords存儲查詢結果。這個結果是分頁計算的基礎。

  3. 動態分頁：根據當前頁數$page和每頁記錄數$recordsPerPage計算出OFFSET ，然後用LIMIT和OFFSET來獲取當前頁的數據。

  4. 分頁導航：通過計算總頁數$totalPages ，然後根據當前頁$page動態生成分頁鏈接。我們使用http://gitbox.net/your_page.php?page=X來實現分頁導航，其中X是頁碼。

5. 小貼士

  • PDOStatement::rowCount()方法對於某些數據庫（如MySQL）能正確返回SELECT語句的影響行數，但對於其他一些數據庫（如PostgreSQL），該方法可能無法正確返回。為確保分頁的準確性，我們通常需要單獨執行COUNT(*)來獲取總記錄數。

  • 在構建分頁導航時，可以根據具體的需求調整每頁顯示的記錄數，或者提供跳轉到某一頁的功能。

6. 總結

使用PDOStatement::rowCount()方法和COUNT(*)查詢來獲取總記錄數，可以幫助我們實現一個高效的動態分頁查詢功能。通過合理的分頁導航，用戶可以方便地瀏覽大量數據，提高了應用的可用性和性能。

相關內容