分頁是 Web 應用中最常見的功能之一。本文介紹一個 PHP 分頁工具類,提供兩種不同的頁碼顯示算法:「滑動尺子法」與「分段處理法」,並附帶完整代碼與示例圖。
將總頁數視為一塊固定長度的木塊,顯示頁碼數(_totalShowPages)為一把可滑動的尺子。目標是找到尺子在木塊上的起始($start)與結束($end)位置。
_curPage)計算 $start、$end,確保尺子不超出邊界。protected function _getShowPageNumber() {
$pageHtml = '';
// 計算起始點
if ($this->_curPage - 2 > 1) {
$start = $this->_curPage - 2;
} else {
$start = 1;
}
// 計算結束點
$end = $start + $this->_totalShowPages;
if ($end >= $this->_totalPages) {
$end = $this->_totalPages;
$start = $end - $this->_totalShowPages;
}
// 首頁與前省略號
if ($start != 1) {
$pageHtml .= $this->_getPageHtml(1);
$preMore = $this->_curPage - $this->_totalShowPages;
if ($preMore < 1) $preMore = 1;
$pageHtml .= $this->_getMorePageHtml($preMore);
}
// 中間頁碼
for ($page = $start; $page < $end; $page++) {
$pageHtml .= $this->_getPageHtml($page);
}
// 後省略號與尾頁
if ($end != $this->_totalPages) {
$pageHtml .= $this->_getMorePageHtml($end);
}
$pageHtml .= $this->_getNormalPageHtml($this->_totalPages);
return $pageHtml;
}
根據當前頁與總顯示頁數的關係,分四種情況處理:
protected function _getShowPageNumberTwo() {
if ($this->_curPage < $this->_totalShowPages) {
for ($page = 1; $page < $this->_totalShowPages; $page++) {
$pageHtml .= $this->_getPageHtml($page);
}
$pageHtml .= $this->_getMorePageHtml($this->_totalShowPages);
$pageHtml .= $this->_getNormalPageHtml($this->_totalPages);
} else {
$pageHtml .= $this->_getNormalPageHtml(1);
if ($this->_curPage == $this->_totalShowPages) {
$pageHtml .= $this->_getMorePageHtml(1);
} else {
$pageHtml .= $this->_getMorePageHtml($this->_curPage - $this->_totalShowPages);
}
if ($this->_curPage + $this->_totalShowPages >= $this->_totalPages) {
for ($page = $this->_totalPages - $this->_totalShowPages; $page <= $this->_totalPages; $page++) {
$pageHtml .= $this->_getPageHtml($page);
}
} else {
$start = $this->_curPage - 2;
$end = $this->_curPage + $this->_totalShowPages - 2;
for ($page = $start; $page < $end; $page++) {
$pageHtml .= $this->_getPageHtml($page);
}
$pageHtml .= $this->_getMorePageHtml($this->_curPage + $this->_totalShowPages - 2);
$pageHtml .= $this->_getNormalPageHtml($this->_totalPages);
}
}
return $pageHtml;
}

兩種算法各有優勢:滑動尺子法邏輯清晰、代碼簡潔;分段處理法邊界控制更細緻。實際項目中可根據 UI 需求選擇或結合優化。