PHP MySQL 分頁顯示核心原理與現代實作指南

分頁核心邏輯

分頁需要兩個關鍵參數：

• $pageSize：每頁筆數（如 10、20、50）
• $currentPage：當前頁碼（從 1 開始）

資料庫查詢使用 LIMIT offset, row_count：

offset = ($currentPage - 1) * $pageSize
row_count = $pageSize

SELECT * FROM table LIMIT offset, row_count

完整 PDO 實作範例

<?php
// config.php
$dsn = 'mysql:host=localhost;dbname=shop;charset=utf8mb4';
$user = 'root';
$pass = '';
$options = [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    PDO::ATTR_EMULATE_PREPARES => false,
];
$pdo = new PDO($dsn, $user, $pass, $options);

// list.php
$pageSize = 10;
$currentPage = max(1, (int)($_GET['page'] ?? 1));

// 1. 取得總筆數
$totalStmt = $pdo->query("SELECT COUNT(*) FROM products");
$totalRows = $totalStmt->fetchColumn();
$totalPages = (int)ceil($totalRows / $pageSize);

// 修正頁碼範圍
if ($currentPage > $totalPages) $currentPage = max(1, $totalPages);

$offset = ($currentPage - 1) * $pageSize;

// 2. 查詢當頁資料
$dataStmt = $pdo->prepare("SELECT id, name, price, created_at FROM products ORDER BY created_at DESC LIMIT :limit OFFSET :offset");
$dataStmt->bindValue(':limit', $pageSize, PDO::PARAM_INT);
$dataStmt->bindValue(':offset', $offset, PDO::PARAM_INT);
$dataStmt->execute();
$products = $dataStmt->fetchAll();

// 3. 顯示資料
?>
<!DOCTYPE html>
<html><head><meta charset="UTF-8"><title>商品列表</title></head><body>
<table border="1" cellpadding="8" cellspacing="0">
    <tr><th>ID</th><th>名稱</th><th>價格</th><th>建立時間</th></tr>
    <?php foreach ($products as $p): ?>
    <tr>
        <td><?= $p['id'] ?></td>
        <td><?= htmlspecialchars($p['name']) ?></td>
        <td>$<?= number_format($p['price'], 2) ?></td>
        <td><?= $p['created_at'] ?></td>
    </tr>
    <?php endforeach; ?>
</table>

<nav aria-label="分頁導航">
    <?php if ($totalPages > 1): ?>
        <ul style="display:flex; gap:0.5rem; list-style:none; padding:0;">
            <?php if ($currentPage > 1): ?>
                <li><a href="?page=<?= $currentPage - 1 ?>">上一頁</a></li>
            <?php endif; ?>
            
            <?php 
            // 顯示頁碼範圍：當前頁前後各 2 頁
            $start = max(1, $currentPage - 2);
            $end = min($totalPages, $currentPage + 2);
            if ($start > 1) echo '<li><a href="?page=1">1</a></li><li>...</li>';
            for ($i = $start; $i <= $end; $i++): ?>
                <li><a href="?page=<?= $i ?>" style="<?= $i === $currentPage ? 'font-weight:bold;color:red;' : '' ?>"><?= $i ?></a></li>
            <?php endfor; ?>
            <?php if ($end < $totalPages) echo '<li>...</li><li><a href="?page=<?= $totalPages ?>"><?= $totalPages ?></a></li>'; ?>
            
            <?php if ($currentPage < $totalPages): ?>
                <li><a href="?page=<?= $currentPage + 1 ?>">下一頁</a></li>
            <?php endif; ?>
        </ul>
        <p>共 <?= $totalRows ?> 筆 / 第 <?= $currentPage ?> / <?= $totalPages ?> 頁</p>
    <?php endif; ?>
</nav>
</body></html>

大資料量效能優化

游標分頁實作（適合無限滾動/大數據）

<?php
$pageSize = 20;
$lastId = (int)($_GET['last_id'] ?? 0);  // 第一頁傳 0

$stmt = $pdo->prepare("SELECT id, name, price FROM products WHERE id > :last_id ORDER BY id ASC LIMIT :limit");
$stmt->bindValue(':last_id', $lastId, PDO::PARAM_INT);
$stmt->bindValue(':limit', $pageSize, PDO::PARAM_INT);
$stmt->execute();
$items = $stmt->fetchAll();

$nextLastId = $items ? end($items)['id'] : 0;
$hasMore = count($items) === $pageSize;

// JSON 回應（AJAX 無限滾動）
header('Content-Type: application/json');
echo json_encode([
    'items' => $items,
    'next_last_id' => $nextLastId,
    'has_more' => $hasMore,
]);

建立測試資料表

CREATE TABLE `products` (
    `id` INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
    `name` VARCHAR(200) NOT NULL,
    `price` DECIMAL(10,2) NOT NULL DEFAULT 0,
    `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

-- 插入測試資料
INSERT INTO `products` (`name`, `price`) VALUES
('商品 A', 100.00), ('商品 B', 250.50), ('商品 C', 89.90);

1. 上一篇文章： PHP XOR 加密演算法實作與安全性分析
2. 下一篇文章： PHP MySQL SQL 建構器類：參數化生成 SELECT/INSERT/UPDATE/DELETE

PHP 綜合知識

PHP range() 函數深度解析：快速生成連續數組與抽獎應用

range() 函數速覽 range() 是 PHP 內建函

微信公眾號客服介面開發完整實作（C# WinForm + PHP 後端邏輯參考）

前言 本文記錄微信公眾號客服功能的開發實作，主要展示 C#

用 Composer 打造專屬 PHP 框架（二）：構建路由系統

前情提要 上篇已建立空的 Composer 專案，本篇講述如

Laravel 4.2 從零打造會員註冊登入系統完整教學

本教學帶領讀者從環境建置開始，逐步完成 Laravel 4.