分頁組件是 Web 應用基礎設施。本文提供一個零依賴、純邏輯的 PageModel::getPageArr() 靜態方法,輸入「當前頁、總記錄數、顯示頁碼數量、每頁條數」,輸出結構化頁碼陣列,前端直接渲染即可。
/**
* @param int $page 當前頁碼(1-based)
* @param int $goodsCount 總記錄數
* @param int $pageCountLength 顯示頁碼數量(如 5、7、9)
* @param int $pageLength 每頁記錄數
* @return array ['page'=>頁碼] 結構化陣列
*/
$page <= 中點):輸出 1~顯示數量。$page > 總頁數 - 中點):輸出 尾部連續顯示數量頁。 $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 專用鍵,前端直接渲染「上一頁/下一頁」。appends(request()->except('page')))。total、per_page、current_page、last_page 完整分頁元數據,兼容 Bootstrap/Vue/React 分頁組件。LengthAwarePaginator 介面,無縫對接 Laravel 內建分頁。此類純邏輯分頁類無框架綁定,可直接用於 ThinkPHP、CodeIgniter、原生 PHP 甚至 Node.js(移植邏輯)專案,是「造輪子」的優秀參考實現。