完整可執行範例程式碼
<?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 limit | LIMIT $offset, $perPage | MySQL 語法:起始位置, 筆數 |
| 上一頁 | 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,效能更佳。