萬盛學電腦網

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

ThinkPHP 分頁類完整使用指南:控制器邏輯、模板渲染、URL 美化、AJAX 無刷新

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();
    }
}

二、模板渲染 (index.html)

<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>

三、進階定制

1. 自定義 URL 規則(配合路由)

$page = new \Think\Page($count, 15, [
    'var_page' => 'page',
    'urlrule'  => '/list/page/:page', // 生成 /list/page/2 這樣的 URL
]);
// 需配合路由配置:
// 'list/page/:page' => 'MsgManage/index',

2. AJAX 無刷新分頁

模板中分頁容器添加 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;
}

3. 自定義顯示模板 (theme)

$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        // 頁碼參數名

六、遷移到 ThinkPHP 5/6/8 的注意

  • 命名空間: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 增強,即可應對絕大多數分頁場景。

copyright © 萬盛學電腦網 all rights reserved