程式師世界 >> 編程語言 >> 網頁編程 >> PHP編程 >> 關於PHP編程 >> ThinkPHP分頁類的使用相關問題，thinkphp分頁

ThinkPHP分頁類的使用相關問題，thinkphp分頁

編輯：關於PHP編程

ThinkPHP分頁類的使用相關問題，thinkphp分頁

ThinkPHP3.2.3
Page.class.php文件源碼

<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK IT ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006-2014 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: 麥當苗兒 <[email protected]> <http://www.zjzit.cn>
// +----------------------------------------------------------------------
namespace Think;

class Page{
    public $firstRow; // 起始行數
    public $listRows; // 列表每頁顯示行數
    public $parameter; // 分頁跳轉時要帶的參數
    public $totalRows; // 總行數
    public $totalPages; // 分頁總頁面數
    public $rollPage   = 11;// 分頁欄每頁顯示的頁數
    public $lastSuffix = true; // 最後一頁是否顯示總頁數

    private $p       = 'p'; //分頁參數名
    private $url     = ''; //當前鏈接URL
    private $nowPage = 1;

    // 分頁顯示定制
    private $config  = array(
        'header' => '<span class="rows">共 %TOTAL_ROW% 條記錄</span>',
        'prev'   => '<<',
        'next'   => '>>',
        'first'  => '1...',
        'last'   => '...%TOTAL_PAGE%',
        'theme'  => '%FIRST% %UP_PAGE% %LINK_PAGE% %DOWN_PAGE% %END%',
    );

    /**
     * 架構函數
     * @param array $totalRows  總的記錄數
     * @param array $listRows  每頁顯示記錄數
     * @param array $parameter  分頁跳轉的參數
     */
    public function __construct($totalRows, $listRows=20, $parameter = array()) {
        C('VAR_PAGE') && $this->p = C('VAR_PAGE'); //設置分頁參數名稱
        /* 基礎設置 */
        $this->totalRows  = $totalRows; //設置總記錄數
        $this->listRows   = $listRows;  //設置每頁顯示行數
        $this->parameter  = empty($parameter) ? $_GET : $parameter;
        $this->nowPage    = empty($_GET[$this->p]) ? 1 : intval($_GET[$this->p]);
        $this->nowPage    = $this->nowPage>0 ? $this->nowPage : 1;
        $this->firstRow   = $this->listRows * ($this->nowPage - 1);
    }

    /**
     * 定制分頁鏈接設置
     * @param string $name  設置名稱
     * @param string $value 設置值
     */
    public function setConfig($name,$value) {
        if(isset($this->config[$name])) {
            $this->config[$name] = $value;
        }
    }

    /**
     * 生成鏈接URL
     * @param  integer $page 頁碼
     * @return string
     */
    private function url($page){
        return str_replace(urlencode('[PAGE]'), $page, $this->url);
    }

    /**
     * 組裝分頁鏈接
     * @return string
     */
    public function show() {
        if(0 == $this->totalRows) return '';

        /* 生成URL */
        $this->parameter[$this->p] = '[PAGE]';
        $this->url = U(ACTION_NAME, $this->parameter);
        /* 計算分頁信息 */
        $this->totalPages = ceil($this->totalRows / $this->listRows); //總頁數
        if(!empty($this->totalPages) && $this->nowPage > $this->totalPages) {
            $this->nowPage = $this->totalPages;
        }

        /* 計算分頁臨時變量 */
        $now_cool_page      = $this->rollPage/2;
        $now_cool_page_ceil = ceil($now_cool_page);
        $this->lastSuffix && $this->config['last'] = $this->totalPages;

        //上一頁
        $up_row  = $this->nowPage - 1;
        $up_page = $up_row > 0 ? '<a class="prev" href="' . $this->url($up_row) . '">' . $this->config['prev'] . '</a>' : '';

        //下一頁
        $down_row  = $this->nowPage + 1;
        $down_page = ($down_row <= $this->totalPages) ? '<a class="next" href="' . $this->url($down_row) . '">' . $this->config['next'] . '</a>' : '';

        //第一頁
        $the_first = '';
        if($this->totalPages > $this->rollPage && ($this->nowPage - $now_cool_page) >= 1){
            $the_first = '<a class="first" href="' . $this->url(1) . '">' . $this->config['first'] . '</a>';
        }

        //最後一頁
        $the_end = '';
        if($this->totalPages > $this->rollPage && ($this->nowPage + $now_cool_page) < $this->totalPages){
            $the_end = '<a class="end" href="' . $this->url($this->totalPages) . '">' . $this->config['last'] . '</a>';
        }

        //數字連接
        $link_page = "";
        for($i = 1; $i <= $this->rollPage; $i++){
            if(($this->nowPage - $now_cool_page) <= 0 ){
                $page = $i;
            }elseif(($this->nowPage + $now_cool_page - 1) >= $this->totalPages){
                $page = $this->totalPages - $this->rollPage + $i;
            }else{
                $page = $this->nowPage - $now_cool_page_ceil + $i;
            }
            if($page > 0 && $page != $this->nowPage){

                if($page <= $this->totalPages){
                    $link_page .= '<a class="num" href="' . $this->url($page) . '">' . $page . '</a>';
                }else{
                    break;
                }
            }else{
                if($page > 0 && $this->totalPages != 1){
                    $link_page .= '<span class="current">' . $page . '</span>';
                }
            }
        }

        //替換分頁內容
        $page_str = str_replace(
            array('%HEADER%', '%NOW_PAGE%', '%UP_PAGE%', '%DOWN_PAGE%', '%FIRST%', '%LINK_PAGE%', '%END%', '%TOTAL_ROW%', '%TOTAL_PAGE%'),
            array($this->config['header'], $this->nowPage, $up_page, $down_page, $the_first, $link_page, $the_end, $this->totalRows, $this->totalPages),
            $this->config['theme']);
        return "<div>{$page_str}</div>";
    }
}

通常在數據查詢後都會對數據集進行分頁操作，ThinkPHP也提供了分頁類來對數據分頁提供支持。下面是數據分頁的兩種示例。

第一種：利用Page類和limit方法

$User = M('User'); // 實例化User對象
$count      = $User->where('status=1')->count();// 查詢滿足要求的總記錄數
$Page       = new \Think\Page($count,25);// 實例化分頁類 傳入總記錄數和每頁顯示的記錄數(25)
$show       = $Page->show();// 分頁顯示輸出
// 進行分頁數據查詢 注意limit方法的參數要使用Page類的屬性
$list = $User->where('status=1')->order('create_time')->limit($Page->firstRow.','.$Page->listRows)->select();
$this->assign('list',$list);// 賦值數據集
$this->assign('page',$show);// 賦值分頁輸出
$this->display(); // 輸出模板

第二種：分頁類和page方法的實現

$User = M('User'); // 實例化User對象
// 進行分頁數據查詢 注意page方法的參數的前面部分是當前的頁數使用 $_GET[p]獲取
$list = $User->where('status=1')->order('create_time')->page($_GET['p'].',25')->select();
$this->assign('list',$list);// 賦值數據集
$count      = $User->where('status=1')->count();// 查詢滿足要求的總記錄數
$Page       = new \Think\Page($count,25);// 實例化分頁類 傳入總記錄數和每頁顯示的記錄數
$show       = $Page->show();// 分頁顯示輸出
$this->assign('page',$show);// 賦值分頁輸出
$this->display(); // 輸出模板

帶入查詢條件
如果是POST方式查詢，如何確保分頁之後能夠保持原先的查詢條件呢，我們可以給分頁類傳入參數，方法是給分頁類的parameter屬性賦值

$count      = $User->where($map)->count();// 查詢滿足要求的總記錄數
$Page       = new \Think\Page($count,25);// 實例化分頁類 傳入總記錄數和每頁顯示的記錄數
//分頁跳轉的時候保證查詢條件
foreach($map as $key=>$val) {
    $Page->parameter[$key]   =   urlencode($val);
}
$show       = $Page->show();// 分頁顯示輸出

分頁樣式定制
我們可以對輸出的分頁樣式進行定制，分頁類Page提供了一個setConfig方法來修改默認的一些設置。例如：

$page->setConfig('header','<li class="rows">共<b>%TOTAL_ROW%</b>條記錄&nbsp;&nbsp;第<b>%NOW_PAGE%</b>頁/共<b>%TOTAL_PAGE%</b>頁</li>');
            $page->setConfig('prev', '上一頁');
            $page->setConfig('next', '下一頁');
            $page->setConfig('first', '首頁');
            $page->setConfig('last', '尾頁');    
            $page->setConfig('theme', '%FIRST% %UP_PAGE% %LINK_PAGE% %DOWN_PAGE% %END% %HEADER%');

setConfig方法支持的屬性包括：
header：頭部描述信息，默認值 “共 %TOTAL_ROW% 條記錄”
next：下一頁描述信息，默認值 “>>”
first：第一頁描述信息，默認值 “1…”
last：最後一頁描述信息，默認值 “…%TOTAL_PAGE%”
theme ：分頁主題描述信息，包括了上面所有元素的組合，設置該屬性可以改變分頁的各個單元的顯示位置，默認值是 “%FIRST% %UP_PAGE% %LINK_PAGE% %DOWN_PAGE% %END%”

其中，顯示位置的對應的關系為：
位置說明
%FIRST% 表示第一頁的鏈接顯示
%UP_PAGE% 表示上一頁的鏈接顯示
%LINK_PAGE% 表示分頁的鏈接顯示
%DOWN_PAGE% 表示下一頁的鏈接顯示
%END% 表示最後一頁的鏈接顯示
除了改變顯示信息外，你還可以使用樣式來定義分頁的顯示效果。這些樣式class包括：first（第一頁）、prev（上一頁）、next（下一頁）、end（最後一頁）、num（其他頁的數字）、current（當前頁）。

ThinkPHP系統分頁類寫的已經很完善只要花幾分鐘時間研究一下源代碼即可，官方注釋也很清晰。這裡注解一下使用中的問題。系統默認設置了

thinkphp分頁

public $rollPage   = 11;// 分頁欄每頁顯示的頁數
public $lastSuffix = true; // 最後一頁是否顯示總頁數

　　一開始看注釋還不是很清楚，其實第一個參數是控制顯示多少頁數，如果默認顯示11個頁碼一般太長，個人喜歡設置為5，當然修改這些參數不要在系統源文件中修改，而是在使用的時候設置$page->rollPage=5即可。

　　而第二個參數就比較坑人了，我們在個性化分頁顯示的時候通常會采用setConfig('last','尾頁')； 用來設置最後一頁顯示為“尾頁”，但是在show方法中可以看到tp在$this->lastSuffix 為真的時候重置該$this->config['last']的值為總頁數這樣導致無論你怎麼設置最後一業都顯示為數字。也不知道官方為什麼這麼設置，解決辦法依然是重新設置$page->lastSuffix = false; 即可。
分頁類