萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 簡易分頁教學範例:MySQL LIMIT 分頁核心邏輯完整解析

完整可執行範例程式碼

<?php
header('Content-Type: text/html; charset=utf-8');

// 資料庫連線(範例使用 mysqli,原碼為舊版 mysql_* 已棄用)
$conn = new mysqli('localhost', 'root', '111', 'test');
if ($conn->connect_error) die('連線失敗: ' . $conn->connect_error);
$conn->set_charset('utf8');

// 1. 取得總筆數
$totalResult = $conn->query('SELECT COUNT(*) FROM `user`');
$total = $totalResult->fetch_row()[0];

// 2. 分頁參數設定
$perPage = 5;                    // 每頁筆數
$totalPages = ceil($total / $perPage); // 總頁數
$page = isset($_GET['p']) ? max(1, min((int)$_GET['p'], $totalPages)) : 1; // 當前頁(邊界檢查)
$offset = ($page - 1) * $perPage; // LIMIT offset

// 3. 查詢當頁資料
$sql = "SELECT * FROM `user` ORDER BY `id` LIMIT $offset, $perPage";
$result = $conn->query($sql);

// 4. 輸出表格
echo '<center><h2>PHP 分頁示範</h2>';
echo '<table border=\"1\" width=\"700\">';
echo '<tr><th>ID</th><th>USER</th><th>PASS</th></tr>';

while ($row = $result->fetch_assoc()) {
    echo '<tr>';
    echo '<td>' . htmlspecialchars($row['id']) . '</td>';
    echo '<td>' . htmlspecialchars($row['name']) . '</td>';
    echo '<td>' . htmlspecialchars($row['pass']) . '</td>';
    echo '</tr>';
}
echo '</table>';

// 5. 分頁導航
$prevPage = max(1, $page - 1);
$nextPage = min($totalPages, $page + 1);

echo '<h3>';
echo '<a href=\"?p=' . $prevPage . '\"><< 上一頁</a> | ';
echo '<a href=\"?p=' . $nextPage . '\">下一頁 >></a>';
echo ' (第 ' . $page . ' / ' . $totalPages . ' 頁)';
echo '</h3></center>';

$conn->close();
?>

核心邏輯圖解

總筆數 total = 17
每頁筆數 perPage = 5
總頁數 totalPages = ceil(17/5) = 4

頁碼 page = 3
offset = (3-1) * 5 = 10
LIMIT 10, 5  →  第 11-15 筆資料

頁碼 page = 4 (最後一頁)
offset = (4-1) * 5 = 15
LIMIT 15, 5  →  第 16-17 筆資料(實際只回傳 2 筆)

關鍵公式速記

變數公式說明
總頁數ceil($total / $perPage)無條件進位
當前頁max(1, min($page, $totalPages))限制在 1~總頁數區間
SQL offset($page - 1) * $perPage跳過前幾頁的筆數
SQL limitLIMIT $offset, $perPageMySQL 語法:起始位置, 筆數
上一頁max(1, $page - 1)不小於 1
下一頁min($totalPages, $page + 1)不大於總頁數

進階分頁導航(數字頁碼)

<?php
// 顯示頁碼範圍:當前頁前後各 2 頁
$range = 2;
$start = max(1, $page - $range);
$end = min($totalPages, $page + $range);

echo '<div class=\"pagination\">';
if ($page > 1) echo '<a href=\"?p=1\">首頁</a> ';
if ($page > 1) echo '<a href=\"?p=' . ($page-1) . '\">«</a> ';

for ($i = $start; $i <= $end; $i++) {
    if ($i == $page) {
        echo '<span class=\"current\">' . $i . '</span> ';
    } else {
        echo '<a href=\"?p=' . $i . '\">' . $i . '</a> ';
    }
}

if ($page < $totalPages) echo '<a href=\"?p=' . ($page+1) . '\">»</a> ';
if ($page < $totalPages) echo '<a href=\"?p=' . $totalPages . '\">尾頁</a>';
echo '</div>';
?>

安全性與最佳實務

  • 使用 mysqli 或 PDO 取代已移除的 mysql_* 函數。
  • $page 強制轉 int 並做邊界檢查,防 SQL 注入。
  • 輸出資料時使用 htmlspecialchars() 防 XSS。
  • 大量資料建議使用「游標分頁」(WHERE id > $lastId LIMIT $perPage)替代 OFFSET,效能更佳。
copyright © 萬盛學電腦網 all rights reserved