ThinkPHP3.2.3 Page.class.php文件源碼 <?php // +---------------------------------------------------------------------- // | ThinkPHP [ WE CAN DO IT JUST TH
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>條記錄 第<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系統分頁類寫的已經很完善只要花幾分鐘時間研究一下源代碼即可,官方註釋也很清晰。這裡註解一下使用中的問題。系統預設設置了
public $rollPage = 11;// 分頁欄每頁顯示的頁數
public $lastSuffix = true; // 最後一頁是否顯示總頁數
一開始看註釋還不是很清楚,其實第一個參數是控制顯示多少頁數,如果預設顯示11個頁碼一般太長,個人喜歡設置為5,當然修改這些參數不要在系統源文件中修改,而是在使用的時候設置$page->rollPage=5
即可。
而第二個參數就比較坑人了,我們在個性化分頁顯示的時候通常會採用setConfig('last','尾頁');
用來設置最後一頁顯示為“尾頁”,但是在show方法中可以看到tp在$this->lastSuffix
為真的時候重置該$this->config['last']
的值為總頁數這樣導致無論你怎麼設置最後一業都顯示為數字。也不知道官方為什麼這麼設置,解決辦法依然是重新設置$page->lastSuffix = false;
即可。