PHP 分頁技術實現指南：從基礎邏輯到現代最佳實踐

PHP 分頁功能核心邏輯解析

分頁是 Web 應用中處理大量數據展示的基礎技術。本文將系統梳理 PHP 分頁的核心原理、傳統實現方式，並對比現代框架中的最佳實踐，幫助開發者構建高效、可維護的分頁組件。

傳統分頁實現的核心步驟

早期 PHP 開發中（如 PHP 4/5 時代），分頁通常遵循以下流程：

1. 獲取當前頁碼：通過 `$_GET['page']` 或類似參數接收，預設為第一頁。
2. 設定每頁筆數：如 `$pageSize = 10`。
3. 查詢總記錄數：執行 `SELECT COUNT(*) FROM table` 獲取 `$totalRows`。
4. 計算總頁數：`$totalPages = ceil($totalRows / $pageSize)`。
5. 計算偏移量：`$offset = ($currentPage - 1) * $pageSize`。
6. 執行帶 LIMIT 的查詢：`SELECT * FROM table ORDER BY id DESC LIMIT $offset, $pageSize`。
7. 渲染分頁導航：生成首頁、上一頁、頁碼、下一頁、尾頁等鏈接。

代碼示例：經典分頁邏輯（教學用）

<?php
// 1. 獲取並驗證當前頁碼
$currentPage = isset($_GET['page']) ? max(1, intval($_GET['page'])) : 1;

// 2. 配置參數
$pageSize = 10;

// 3. 連接數據庫（建議使用 PDO 或 MySQLi）
$pdo = new PDO('mysql:host=localhost;dbname=testdb;charset=utf8', 'user', 'pass');

// 4. 獲取總記錄數
$stmt = $pdo->query('SELECT COUNT(*) FROM articles');
$totalRows = $stmt->fetchColumn();
$totalPages = ceil($totalRows / $pageSize);

// 5. 修正頁碼範圍
$currentPage = min($currentPage, max(1, $totalPages));

// 6. 查詢當前頁數據
$offset = ($currentPage - 1) * $pageSize;
$stmt = $pdo->prepare('SELECT id, title, author, created_at FROM articles ORDER BY id DESC LIMIT :offset, :limit');
$stmt->bindValue(':offset', $offset, PDO::PARAM_INT);
$stmt->bindValue(':limit', $pageSize, PDO::PARAM_INT);
$stmt->execute();
$articles = $stmt->fetchAll(PDO::FETCH_ASSOC);
?>

<!-- 7. 顯示數據表格 -->
<table class="table">
    <thead>
        <tr><th>ID</th><th>標題</th><th>作者</th><th>發布時間</th></tr>
    </thead>
    <tbody>
    <?php foreach ($articles as $row): ?>
        <tr>
            <td><?= htmlspecialchars($row['id']) ?></td>
            <td><?= htmlspecialchars($row['title']) ?></td>
            <td><?= htmlspecialchars($row['author']) ?></td>
            <td><?= htmlspecialchars($row['created_at']) ?></td>
        </tr>
    <?php endforeach; ?>
    </tbody>
</table>

<!-- 8. 渲染分頁導航 -->
<nav aria-label="分頁導航">
    <ul class="pagination">
        <?php if ($currentPage > 1): ?>
            <li><a href="?page=1">首頁</a></li>
            <li><a href="?page=<?= $currentPage - 1 ?>">上一頁</a></li>
        <?php endif; ?>

        <?php 
        // 顯示頁碼範圍（如當前頁前後各 2 頁）
        $start = max(1, $currentPage - 2);
        $end = min($totalPages, $currentPage + 2);
        for ($i = $start; $i <= $end; $i++): ?>
            <li class="<?= $i === $currentPage ? 'active' : '' ?>">
                <a href="?page=<?= $i ?>"><?= $i ?></a>
            </li>
        <?php endfor; ?>

        <?php if ($currentPage < $totalPages): ?>
            <li><a href="?page=<?= $currentPage + 1 ?>">下一頁</a></li>
            <li><a href="?page=<?= $totalPages ?>">尾頁</a></li>
        <?php endif; ?>
    </ul>
</nav>

現代開發中的分頁最佳實踐

1. 使用成熟的分頁庫

生產環境建議使用經過驗證的庫，而非手寫邏輯：

• Laravel：內建 `LengthAwarePaginator`，支援 Eloquent 與 Query Builder 無縫整合。
• Symfony：`KnpPaginatorBundle` 提供豐富的模板自定義與 AJAX 支援。
• 獨立庫：`jasny/php-pagination`、`php-pagination/php-pagination` 等輕量級選擇。

2. 大數據集的性能優化

• 避免 OFFSET 深分頁：當頁碼極大時，`LIMIT 100000, 10` 需掃描前 10 萬行。改用「游標分頁」：`WHERE id > :lastId ORDER BY id LIMIT 10`。
• 覆蓋索引優化 COUNT(*)：對於億級表，`COUNT(*)` 緩慢。可維護計數表、使用近似值（`EXPLAIN` 的 rows）、或異步更新緩存總數。
• 緩存分頁片段：熱門列表頁（如首頁、分類頁）可緩存 HTML 片段，減少數據庫壓力。

3. API 分頁規範

RESTful API 推薦採用標準化回應格式：

{
  "data": [...],
  "meta": {
    "current_page": 3,
    "per_page": 15,
    "total": 342,
    "last_page": 23,
    "links": {
      "first": "/api/articles?page=1",
      "prev": "/api/articles?page=2",
      "next": "/api/articles?page=4",
      "last": "/api/articles?page=23"
    }
  }
}

常見陷阱與避坑指南

前端交互增強

• AJAX 無刷新分頁：配合 `fetch` 或 `axios` 獲取 JSON，局部更新列表與分頁條，保留滾動位置。
• 無限滾動：移動端常用，滾動到底部自動載入下一頁，需提供「載入更多」按鈕作為降級。
• URL 狀態同步：使用 `history.pushState` 更新 URL 參數，支援瀏覽器前進/後退、分享鏈接直達指定頁。

總結

分頁看似簡單，實則涉及數據庫優化、用戶體驗、架構規範等多維考量。初學者應先掌握基礎邏輯與手寫實現，理解 `LIMIT/OFFSET` 原理；進階開發者則應熟悉框架內建組件、大數據優化策略、API 設計規範，並根據業務場景選擇傳統分頁、游標分頁或無限滾動。記住：沒有銀彈，只有適合當前業務規模與增長預期的方案。