分頁是列表頁核心元件。本文提供一個靜態方法 Page::getPageHtml(),支援:
<ul class="pagination"> 結構class Page {
/**
* 取得分頁 HTML
* @param int $page 當前頁 (從 1 開始)
* @param int $pages 總頁數
* @param string $url 基礎 URL,頁碼以 &page=x 附加
* @return string HTML 字串
*/
public static function getPageHtml($page, $pages, $url) {
$_pageNum = 5; // 最多顯示頁碼數
// 邊界修正
$page = $page < 1 ? 1 : $page;
$page = $page > $pages ? $pages : $page;
$pages = $pages < $page ? $page : $pages;
// 計算起始/結束頁
$_start = $page - floor($_pageNum / 2);
$_start = $_start < 1 ? 1 : $_start;
$_end = $page + floor($_pageNum / 2);
$_end = $_end > $pages ? $pages : $_end;
// 當顯示頁數不足時,左右擴展
$_curPageNum = $_end - $_start + 1;
if ($_curPageNum < $_pageNum && $_start > 1) {
$_start -= ($_pageNum - $_curPageNum);
$_start = $_start < 1 ? 1 : $_start;
$_curPageNum = $_end - $_start + 1;
}
if ($_curPageNum < $_pageNum && $_end < $pages) {
$_end += ($_pageNum - $_curPageNum);
$_end = $_end > $pages ? $pages : $_end;
}
// 組裝 HTML
$_pageHtml = '';
// 上一頁
if ($page > 1) {
$_pageHtml .= '- «
';
}
// 頁碼
for ($i = $_start; $i <= $_end; $i++) {
if ($i == $page) {
$_pageHtml .= '- ' . $i . '
';
} else {
$_pageHtml .= '- ' . $i . '
';
}
}
// 下一頁
if ($page < $_end) {
$_pageHtml .= '- »
';
}
$_pageHtml .= '
';
echo $_pageHtml;
}
}
// 使用範例
Page::getPageHtml(3, 20, 'https://example.com/list?cat=5');
<ul class="pagination">
<li><a title="上一頁" href="https://example.com/list?cat=5&page=2">«</a></li>
<li><a href="https://example.com/list?cat=5&page=1">1</a></li>
<li><a href="https://example.com/list?cat=5&page=2">2</a></li>
<li class="active"><a>3</a></li>
<li><a href="https://example.com/list?cat=5&page=4">4</a></li>
<li><a href="https://example.com/list?cat=5&page=5">5</a></li>
<li><a title="下一頁" href="https://example.com/list?cat=5&page=4">»</a></li>
</ul>

$pageNum 參數讓呼叫端決定顯示幾個頁碼。first/last 首尾頁連結(註解部分已預留)。LengthAwarePaginator (Laravel) 或 Paginator (ThinkPHP) 直接輸出。rel="prev/next" SEO 標籤。