萬盛學電腦網

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

PHP 分頁函數完整實作:支援 URL 參數保留、下拉跳頁、自定義顯示筆數

函數特色

  • 自動解析並保留現有 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 設定上限。
copyright © 萬盛學電腦網 all rights reserved