萬盛學電腦網

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

PHP 簡易分頁類實現:自動計算頁碼範圍、首尾頁、前後鄰近頁的靈活邏輯

分頁組件是 Web 應用基礎設施。本文提供一個零依賴、純邏輯的 PageModel::getPageArr() 靜態方法,輸入「當前頁、總記錄數、顯示頁碼數量、每頁條數」,輸出結構化頁碼陣列,前端直接渲染即可。

方法簽名

/**
 * @param int $page           當前頁碼(1-based)
 * @param int $goodsCount     總記錄數
 * @param int $pageCountLength 顯示頁碼數量(如 5、7、9)
 * @param int $pageLength     每頁記錄數
 * @return array ['page'=>頁碼] 結構化陣列
 */

核心邏輯:三段式頁碼範圍計算

  1. 總頁數 ≤ 顯示數量:直接輸出 1~總頁數。
  2. 當前頁靠近首頁($page <= 中點):輸出 1~顯示數量。
  3. 當前頁靠近尾頁($page > 總頁數 - 中點):輸出 尾部連續顯示數量頁。
  4. 當前頁在中間:以當前頁為中心,左右擴展至顯示數量。

完整代碼

 $i];
            }
            return $arr;
        }

        $halfLength = (int)floor($pageCountLength / 2);

        // 情況 2:當前頁在左側
        if ($page <= $halfLength) {
            $arr = [];
            for ($i = 1; $i <= $pageCountLength; $i++) {
                $arr[] = ['page' => $i];
            }
            return $arr;
        }

        // 情況 3:當前頁在右側
        if ($page > $allPageCount - $halfLength) {
            $arr = [];
            for ($i = -$pageCountLength + 1; $i <= 0; $i++) {
                $arr[] = ['page' => $allPageCount + $i];
            }
            return $arr;
        }

        // 情況 4:中間區域,居中顯示
        $arr = [];
        for ($i = -$halfLength; $i < $pageCountLength - $halfLength; $i++) {
            $arr[] = ['page' => $page + $i];
        }
        return $arr;
    }
}

// 使用示例
$pages = PageModel::getPageArr(7, 1000, 7, 20); // 第 7 頁,共 1000 條,顯示 7 個頁碼,每頁 20 條
// 輸出:[4,5,6,7,8,9,10] 頁碼陣列

前端渲染建議


擴展方向

  • 增加 prev/next/first/last 專用鍵,前端直接渲染「上一頁/下一頁」。
  • 支援 URL 參數保持(appends(request()->except('page')))。
  • 輸出 total、per_page、current_page、last_page 完整分頁元數據,兼容 Bootstrap/Vue/React 分頁組件。
  • 引入 LengthAwarePaginator 介面,無縫對接 Laravel 內建分頁。

此類純邏輯分頁類無框架綁定,可直接用於 ThinkPHP、CodeIgniter、原生 PHP 甚至 Node.js(移植邏輯)專案,是「造輪子」的優秀參考實現。

copyright © 萬盛學電腦網 all rights reserved