函數特色
- 自動解析並保留現有 URL 參數(避免分頁連結遺失查詢條件)。
- 支援首頁、上一頁、下一頁、尾頁、數字下拉選單跳頁。
- 全域變數輸出
$page(目前頁)、$sqlfirst(SQL LIMIT 起始)、$pagecon(導航 HTML)。
- 單一函數調用即可完成分頁邏輯與導航生成。
核心函數 pageDivide()
<?php
if (!function_exists('pageDivide')) {
/**
* 分頁函數
* @param int $total 總筆數
* @param int $shownu 每頁筆數,預設 20
* @param string $url 當前頁 URL,預設自動偵測
*/
function pageDivide($total, $shownu = 20, $url = '') {
global $page, $sqlfirst, $pagecon, $_SERVER;
$GLOBALS['shownu'] = $shownu;
// 目前頁碼
$page = isset($_GET['page']) ? (int)$_GET['page'] : 1;
// URL 處理:保留原有查詢參數,移除舊 page 參數
if (!$url) $url = $_SERVER['REQUEST_URI'];
$parse = parse_url($url);
$query = $parse['query'] ?? '';
if ($query) {
$query = preg_replace('/(&?)page=\d+/', '', $query);
$url = str_replace($parse['query'], $query, $url);
$url .= ($query ? '&' : '') . 'page';
} else {
$url .= '?page';
}
// 頁碼計算
$lastpg = ceil($total / $shownu); // 總頁數
$page = min($lastpg, max(1, $page)); // 修正頁碼範圍
$prepg = $page - 1;
$nextpg = ($page == $lastpg) ? 0 : $page + 1;
$sqlfirst = ($page - 1) * $shownu; // SQL LIMIT offset
// 導航 HTML 組裝
$pagecon = "顯示第 " . ($total ? ($sqlfirst + 1) : 0) . "-" . min($sqlfirst + $shownu, $total) . " 條,共 <b>$total</b> 條記錄";
if ($lastpg <= 1) return false; // 單頁不顯示分頁
// 首頁/上一頁
$pagecon .= $page != 1 ? " <a href='$url=1'>首頁</a> " : " 首頁 ";
$pagecon .= $prepg ? " <a href='$url=$prepg'>前頁</a> " : " 前頁 ";
// 下一頁/尾頁
$pagecon .= $nextpg ? " <a href='$url=$nextpg'>後頁</a> " : " 後頁 ";
$pagecon .= $page != $lastpg ? " <a href='$url=$lastpg'>尾頁</a> " : " 尾頁 ";
// 下拉跳頁選單
$pagecon .= " 到第 <select name='topage' onchange=\"window.location='$url=' + this.value\">";
for ($i = 1; $i <= $lastpg; $i++) {
$sel = ($i == $page) ? ' selected' : '';
$pagecon .= "<option value='$i'$sel>$i</option>";
}
$pagecon .= "</select> 頁,共 $lastpg 頁";
}
}
?>
使用範例
<?php
require_once 'mypage.php'; // 引入上述函數
// 1. 取得總筆數
$conn = mysqli_connect('localhost', 'root', 'password', 'dbname');
$total = mysqli_fetch_row(mysqli_query($conn, 'SELECT COUNT(*) FROM mytable'))[0];
// 2. 呼叫分頁函數(每頁 10 筆)
pageDivide($total, 10);
// 3. 查詢當頁資料
$sql = "SELECT * FROM mytable LIMIT $sqlfirst, $shownu";
$result = mysqli_query($conn, $sql);
// 4. 輸出資料
while ($row = mysqli_fetch_assoc($result)) {
echo $row['id'] . ' - ' . $row['title'] . '<br>';
}
// 5. 輸出分頁導航
echo $pagecon;
?>
進階優化建議
- 移除全域變數:改回傳陣列
['page'=>, 'sqlfirst'=>, 'pagecon'=>],符合現代開發規範。
- 加入頁碼範圍顯示:當總頁數過大時,僅顯示當前頁前後 N 頁(如 1 ... 5 6 [7] 8 9 ... 50)。
- 支援 AJAX 分頁:回傳 JSON 格式,前端動態渲染。
- 防注入:
$page 強制轉 int,$shownu 設定上限。