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: 麦当苗儿 <zuojiazi@vip.qq.com> <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; // 最后一页是否显示总页数

[/code]
　　一开始看注释还不是很清楚，其实第一个参数是控制显示多少页数，如果默认显示11个页码一般太长，个人喜欢设置为5，当然修改这些参数不要在系统源文件中修改，而是在使用的时候设置

$page->rollPage=5

即可。

　　而第二个参数就比较坑人了，我们在个性化分页显示的时候通常会采用

setConfig('last','尾页')；

用来设置最后一页显示为“尾页”，但是在show方法中可以看到tp在

$this->lastSuffix

为真的时候重置该

$this->config['last']

的值为总页数这样导致无论你怎么设置最后一业都显示为数字。也不知道官方为什么这么设置，解决办法依然是重新设置

$page->lastSuffix = false;

即可。