ThinkPHP 內置 Think\Page 分頁類功能強大,支持多種顯示模式、URL 綁定、AJAX 分頁。本文從數據查詢、分頁實例化、模板變量傳遞、前端渲染、進階定制到常見問題,提供完整實戰指南。
<?php
namespace Home\Controller;
use Think\Controller;
class MsgManageController extends Controller
{
public function index()
{
// 1. 導入分頁類(3.2+ 建議用命名空間)
// import('ORG.Util.Page'); // 3.1 寫法
$Page = new \Think\Page();
// 2. 獲取總記錄數(帶條件)
$map = ['status' => 1]; // 查詢條件
$count = M('Board')->where($map)->count();
// 3. 實例化分頁對象
// 參數:總記錄數、每頁顯示數、參數綁定
$page = new \Think\Page($count, 15, [
'var_page' => 'p', // 頁碼參數名,默認 p
'urlrule' => '', // 自定義 URL 規則,空則自動生成
]);
// 4. 關鍵配置
$page->setConfig('header', '共 %TOTAL_ROW% 條');
$page->setConfig('prev', '« 上一頁');
$page->setConfig('next', '下一頁 »');
$page->setConfig('first', '首頁');
$page->setConfig('last', '末頁');
$page->setConfig('theme', '%HEADER% %FIRST% %UP_PAGE% %LINK_PAGE% %DOWN_PAGE% %END%'); // 顯示模板
// 5. 獲取 LIMIT 參數
$limit = $page->firstRow . ',' . $page->listRows; // 如 "0,15"
// 6. 查詢數據
$list = M('Board')
->where($map)
->order('create_time DESC')
->limit($limit)
->select();
// 7. 生成分頁 HTML
$pageHtml = $page->show();
// 8. 分配模板變量
$this->assign([
'list' => $list,
'page' => $pageHtml,
'count' => $count,
'pageSize' => 15,
]);
$this->display();
}
}
<table class="table table-striped">
<thead>
<tr><th>ID</th><th>標題</th><th>作者</th><th>時間</th><th>操作</th></tr>
</thead>
<tbody>
<volist name="list" id="vo">
<tr>
<td>{$vo.id}</td>
<td>{$vo.title}</td>
<td>{$vo.username}</td>
<td>{$vo.create_time|date="Y-m-d H:i",###}</td>
<td>
<a href="{:U('edit', ['id'=>$vo.id])}">編輯</a> |
<a href="{:U('delete', ['id'=>$vo.id])}" onclick="return confirm('確定刪除?')">刪除</a>
</td>
</tr>
</volist>
</tbody>
</table>
<!-- 分頁容器 -->
<div class="pagination-container">
{$page|raw} <!-- 3.2+ 用 raw 過濾器輸出原始 HTML -->
</div>
$page = new \Think\Page($count, 15, [
'var_page' => 'page',
'urlrule' => '/list/page/:page', // 生成 /list/page/2 這樣的 URL
]);
// 需配合路由配置:
// 'list/page/:page' => 'MsgManage/index',
模板中分頁容器添加 ID,JS 截獲點擊事件:
<div id="page-nav">{$page|raw}</div>
<script>
$('#page-nav').on('click', 'a', function(e) {
e.preventDefault();
var url = $(this).attr('href');
$.get(url, function(html) {
// 假設返回片段包含 table tbody + 新分頁
$('#data-container').html(html);
});
});
</script>
控制器判斷 AJAX 請求返回片段:
if (IS_AJAX) {
$this->assign('list', $list);
$this->display('Index:page_list'); // 只渲染列表+分頁片段
exit;
}
$page->setConfig('theme', '
%HEADER%
%FIRST% %UP_PAGE% %LINK_PAGE% %DOWN_PAGE% %END%
');
| 問題 | 原因 | 解決 |
|---|---|---|
| 分頁連結包含多余參數 | URL 組裝包含了當前所有 GET 參數 | 使用 urlrule 精確控制,或在控制器構建 _GET 過濾 |
| 最後一頁數據為空 | count(*) 與 limit 條件不一致 | 確保 where 條件完全一致,包括軟刪除標誌 |
| 頁碼參數名衝突 | 多個分頁同時存在 | 設置不同 var_page,如 p1, p2 |
| 分頁樣式亂掉 | CSS 衝突 | 給分頁容器加唯一 class,CSS 作用域隔離 |
| 大數據量 count 慢 | 全表掃描 | 1. 觸發器維護計數表 2. 估算行數 3. 延遲加載 |
$page->totalRows // 總記錄數
$page->listRows // 每頁數量
$page->firstRow // 當前頁起始偏移 (0-based)
$page->nowPage // 當前頁碼 (1-based)
$page->totalPages // 總頁數
$page->parameter // 額外 URL 參數陣列
$page->varPage // 頁碼參數名
think\paginator\driver\Bootstrap (TP5/6 內置 Paginator 組件)$list = Db::name('board')->paginate(15); 返回 LengthAwarePaginator 對象。{$list->render()} 直接輸出 Bootstrap 風格分頁。paginate(15, false, ['query' => request()->param()])。ThinkPHP 3.2 的 Page 類雖然老舊,但功能完整、定制性強。掌握其 count → Page → limit → select → show 核心流程,配合模板變量輸出與 JS 增強,即可應對絕大多數分頁場景。