PHP 分頁功能模組完整實作與核心原理解析

效果預覽

核心程式碼

<?php
// 資料庫設定
$localhost = "localhost";
$username = "root";
$password = "root";
$db = "test";

// 分頁參數
$pagesize = 5; // 每頁筆數

// 連線資料庫 (注意：mysql_* 函式已棄用，建議改用 mysqli/PDO)
$conn = mysql_connect($localhost, $username, $password);
if (!$conn) die("資料庫連線失敗: " . mysql_error());

mysql_query("SET NAMES 'UTF8'");
mysql_select_db($db);

// 1. 查詢總筆數
$total_sql = "SELECT COUNT(*) FROM page";
$total_result = mysql_query($total_sql);
$total_row = mysql_fetch_row($total_result);
$total_records = $total_row[0];

// 2. 計算總頁數
$total_pages = ceil($total_records / $pagesize);

// 3. 取得當前頁碼
$page = isset($_GET['p']) ? (int)$_GET['p'] : 1;
if ($page < 1) $page = 1;
if ($page > $total_pages) $page = $total_pages;

// 4. 計算 OFFSET
$offset = ($page - 1) * $pagesize;

// 5. 查詢當頁資料
$sql = "SELECT * FROM page ORDER BY id LIMIT {$offset}, {$pagesize}";
$result = mysql_query($sql);

// 6. 輸出資料表格
echo "<p>PHP 分頁示範模組</p>";
echo "<table border=1 cellspacing=0 width=60% align=center>";
echo "<tr><td>ID</td><td>NAME</td></tr>";
while ($row = mysql_fetch_assoc($result)) {
    echo "<tr><td>{$row['id']}</td><td>{$row['name']}</td></tr>";
}
echo "</table>";

// 7. 上一頁/下一頁連結
$page_prev = $page - 1;
$page_next = ($page < $total_pages) ? $page + 1 : $total_pages;

echo "<h3>";
echo "<a href='page.php?p={$page_prev}'>上一頁</a> | ";
echo "<a href='page.php?p={$page_next}'>下一頁</a>";
echo "</h3>";

mysql_free_result($result);
mysql_close($conn);
?>

核心原理解析

關鍵點 1：LIMIT 子句精準切分資料

SELECT * FROM page ORDER BY id LIMIT {$offset}, {$pagesize}

• OFFSET = ($page - 1) * $pagesize：跳過前幾頁的筆數
• LIMIT = $pagesize：取指定筆數
• MySQL 也支援 LIMIT $pagesize OFFSET $offset 寫法

關鍵點 2：頁碼連結傳遞當前狀態

echo "<a href='page.php?p={$page_prev}'>上一頁</a>";
echo "<a href='page.php?p={$page_next}'>下一頁</a>";

• 透過 URL 參數 p 傳遞目標頁碼
• 伺服器端接收 $_GET['p'] 重新計算 OFFSET
• 無狀態、可書籤、可分享、SEO 友善

進階分頁功能擴展

1. 數字頁碼導航（1 2 3 ... 10）

function render_pagination($current, $total, $baseUrl, $window = 2) {
    $html = '<div class="pagination">';
    
    // 首頁
    if ($current > 1) $html .= "<a href='{$baseUrl}?p=1'>首頁</a> ";
    
    // 上一頁
    if ($current > 1) $html .= "<a href='{$baseUrl}?p=" . ($current-1) . "'>« 上一頁</a> ";
    
    // 數字頁碼
    $start = max(1, $current - $window);
    $end = min($total, $current + $window);
    
    if ($start > 1) $html .= "<span>...</span> ";
    for ($i = $start; $i <= $end; $i++) {
        if ($i == $current) {
            $html .= "<span class='current'>$i</span> ";
        } else {
            $html .= "<a href='{$baseUrl}?p=$i'>$i</a> ";
        }
    }
    if ($end < $total) $html .= "<span>...</span> ";
    
    // 下一頁
    if ($current < $total) $html .= "<a href='{$baseUrl}?p=" . ($current+1) . "'>下一頁 »</a> ";
    
    // 末頁
    if ($current < $total) $html .= "<a href='{$baseUrl}?p={$total}'>末頁</a> ";
    
    $html .= '</div>';
    return $html;
}

2. 現代化資料庫寫法

// 使用 PDO + Prepared Statement
$pdo = new PDO("mysql:host=localhost;dbname=test;charset=utf8", "root", "root");
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

// 總筆數
$stmt = $pdo->query("SELECT COUNT(*) FROM page");
$total = $stmt->fetchColumn();

// 當頁資料
$stmt = $pdo->prepare("SELECT * FROM page ORDER BY id LIMIT :offset, :limit");
$stmt->bindValue(':offset', $offset, PDO::PARAM_INT);
$stmt->bindValue(':limit', $pagesize, PDO::PARAM_INT);
$stmt->execute();
$rows = $stmt->fetchAll(PDO::FETCH_ASSOC);

常見陷阱與避坑指南

分頁是 Web 開發最基礎也最核心的模組之一，掌握其原理與變體對構建高效能列表頁至關重要。