从thinkphp的分页类分析php分页的设计思想

分页

分页是网页上最常见的功能,平时我们浏览网页的时候,都会看到上一页,下一页的连接,还会有跳转到具体哪一页的链接,那么这个分页是如何实现的呢,我们首先从thinkphp的分页类源码分析。

<?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_my{
    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%',
        /*分页显示栏数的格式,如果要添加或减少显示的样式就改这里,例如不想显示尾页,去掉%END%即可*/
        '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()) {
        /*检查分页参数在config文件里是否设置,如果设置了将$p设置额外该参数*/
        C('VAR_PAGE') && $this->p = C('VAR_PAGE'); //设置分页参数名称
        /* 基础设置 */
        $this->totalRows  = $totalRows; //设置总记录数
        $this->listRows   = $listRows;  //设置每页显示行数
 
        /*如果$parameter为空,则取get的参数,否则取设置的参数,
        这里排除了模块控制器方法的get参数,要注意
        例如http://localhost/c/ceshi.php?m=Home&c=Index&a=index&ceshi=ceshi这个链接
        如果$parameter为空,$parameter会等于array('ceshi'=>'ceshi'),
        如果$parameter设置了,那么会忽略get参数里的ceshi,而会采用$parameter设置的参数,
        例如$page=new \Think\Page(20,5,array('pa'=>'pa')),$parameter会等于array('pa'=>'pa');
        */
        $this->parameter  = empty($parameter) ? $_GET : $parameter;
        /*如果get的参数里$p对应的值为空,则将本页取1,否则取$_GET[$p]的整数值赋值给当前页数$nowPage*/
        $this->nowPage    = empty($_GET[$this->p]) ? 1 : intval($_GET[$this->p]);
        /*如果$nowpage大于0则取自身,否则取1*/
        $this->nowPage    = $this->nowPage>0 ? $this->nowPage : 1;
        /*设置每页第一行的数据为每页显示数乘以现在的页数减一,$listRows*($nowpage-1)*/
        $this->firstRow   = $this->listRows * ($this->nowPage - 1);
    }
 
    /**
     * 定制分页链接设置
     * @param string $name  设置名称
     * @param string $value 设置值
     */
    public function setConfig($name,$value) {
        /*如果$config存在$name的键,那么把$value赋值上去*/
        if(isset($this->config[$name])) {
            $this->config[$name] = $value;
        }
    }
 
    /**
     * 生成链接URL
     * @param  integer $page 页码
     * @return string
     */
    private function url($page){
        /*将生成的$url里的urlencode处理过的[PAGE]替换成$page*/
        return str_replace(urlencode('[PAGE]'), $page, $this->url);
    }
 
    /**
     * 组装分页链接
     * @return string
     */
    public function show() {
        /*如果传进来的$totalRows是为0返回空值*/
        if(0 == $this->totalRows) return '';
 
        /* 生成URL */
        /*将$parameter[$p]设置值为[PAGE]*/
        $this->parameter[$this->p] = '[PAGE]';
 
        /*把当前对应的控制器方法和参数放入U函数得到当前链接$url
        例如$page=new \Think\Page_my(20,5,array('ceshi'=>'ceshi'));
        得到的链接会是:/ceshi/ceshi.php/Home/Index/index/ceshi/ceshi/p/%5BPAGE%5D.html
        %5BPAGE%5D就是用urlencode处理过的[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);
 
        /*如果$lastSuffix设置为true,设置$config['last']=$totalPages也就是总页数
          所以如果想设置页码样式的尾页样式的话,需要改动$lastSuffix为false
        */
		$this->lastSuffix && $this->config['last'] = $this->totalPages;
 
        //上一页
        //上一页页数
        $up_row  = $this->nowPage - 1;
 
        //上一页的页码显示
        //如果上一页大于0,那么利用url方法替换得到上一页$up_row的链接,并处理好样式
        //得到的效果例如<a class="prev" href="ceshi/ceshi.php/Home/Index/Index/index/p/$up_row/parameter/parameter.html"
        //如果上一页不大于0,那么上一页的页码样式则为空值
        $up_page = $up_row > 0 ? '<a class="prev" href="' . $this->url($up_row) . '">' . $this->config['prev'] . '</a>' : '';
 
        //下一页
        //下一页页数
        $down_row  = $this->nowPage + 1;
        //如果下一页页数小于等于总页数,那么利用url方法替换得到下一页$down_page的链接,并处理好样式
        //如果大于总页数,那么下一页的页码样式则为空
        $down_page = ($down_row <= $this->totalPages) ? '<a class="next" href="' . $this->url($down_row) . '">' . $this->config['next'] . '</a>' : '';
 
 
        //第一页
        $the_first = '';
        /*如果总页数大于显示的页码数量,
        同时当前页减去显示的页码数量除以2得到的临时变量后任然大于等于1,
        那么$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 = '';
        /*如果总页数大于显示的页码数量,
        同时当前页加上显示页码数量除以2得到的临时变量小于总页数
        那么$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++){
 
 
            /*如果当前页码小于或等于显示栏数的一半,例如每次显示1-11页,
            总共11页,$now_cool_page=5.5,如果当前页小于5.5的话,页码$page=$i*/
			if(($this->nowPage - $now_cool_page) <= 0 ){
				$page = $i;
            /*如果当前页加上显示页栏的一半的页数和已经大于总页数,这种情况例如:总页数20页,
            当前页是18页,如果加上上述假定的1-11页的显示栏数的话,18+4.5大于等于20,这种情况下
            页码等于总页数-显示栏数并加上$i*/
			}elseif(($this->nowPage + $now_cool_page - 1) >= $this->totalPages){
				$page = $this->totalPages - $this->rollPage + $i;
            /*如果没有满足上述两个条件,也就是当前页既不是靠近开始的页数,
            也不是靠近尾页的页数的情况,例如上面20页,显示是1-11页,当前页是12页就是这个情况,
            当前页为12时,会从当前页减去显示栏的一半向上取整的页码开始显示,也就是从7页开始显示,
            一直到17页*/
			}else{
				$page = $this->nowPage - $now_cool_page_ceil + $i;
			}
 
            /*获取显示每次显示的页码栏变量$link_page*/
            /*如果页码大于0且不等于当前页*/
            if($page > 0 && $page != $this->nowPage){
                /*如果页码小于等于总页数,将下面添加到显示页码的显示变量$link_page*/
                if($page <= $this->totalPages){
                    $link_page .= '<a class="num" href="' . $this->url($page) . '">' . $page . '</a>';
                }else{
                    break;
                }
            /*如果页码等于当前页或者小于等于0*/
            }else{
                /*如果页码大于0且总页数不等于1,将下面添加到显示页码的显示变量$link_page*/
                if($page > 0 && $this->totalPages != 1){
                    $link_page .= '<span class="current">' . $page . '</span>';
                }
            }
        }
 
        //替换分页内容
        //将得到的变量根据$config['theme']配置的样式替换成上面得到的变量值
        $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 中的分页类在我看来还是很强大的,使用起来也是很方便的。只要传入总的条数,和每页显示的条数,你就可以轻松显示分页,并且通过配置样式数组,可以方便的调整前台页数代码的样式。

下面介绍一下一些配置参数:

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;//默认第一页

这里是默认的配置参数,如果没有特殊需求,我们不需要关注这里。

我们我们需要关注的是,如何使用这个类。

首先,创建对象,然后传入参数,最后调用show方法,就可以显示分页了。

$count = 100; //为总的页数,25为每页显示的记录数。
$page=new \Think\Page($count, 25);// 实例化分页类 传入总记录数和每页显示的记录数
$show= $page->show();// 分页显示输出

控制每页显示的分页数:

$page->rollPage = 5; //这样就最多显示5个分页数目,

控制总页数的显示

$page->lastSuffix=false;//这个参数是让他最后一页不显示总的数目。因为我们可以通过header来显示总的数目。

显示样式控制

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%',
);

这个是分页样式默认的数组,我们可以通过传入新的值来覆盖它们,

通过调用setConfig方法,我们就可以修改默认参数值,调整我们的样式。

public function setConfig($name,$value) {
      if(isset($this->config[$name])) {
          $this->config[$name] = $value;
      }
  }

这个函数我们可以把默认值覆盖,比如theme里面没有header的信息,我们可以加入%HEADER% 来让他显示出来。而header的内容也可以通过一个key为header的数组来覆盖。其他的参数都是类似的,说明一下,theme里面我们可以自己调整header的位置,而不是固定在前面或者后面,用起来很灵活。

下面说明一下,thinkphp这个分页类是如何通过配置文件来修改它的样式的。

$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']);

这个str_replace可以说是分页类的一个设计精华之处,首先前面将类的各个属性的值分开赋值,最后调用这个函数,读取config中的theme来表示要显示的内容,而其中的变量是通过按照对应的数组来替换的,就实现了将config中的theme(可以子集覆盖默认的theme)来控制如何显示分页及内容顺序。

最后就是thinkphp将常用的前一页,后一页,第一页,当前页都加了默认class,所以我们引入一个css文件就可以改变他的样式了。

设计思想

分页的原理就是使用mysql的limit来进行分页限制查询。通过order排序之后,我们可以通过limit来限制每次查询的起始位置,这样我们就可以控制每次显示的数据。

分页类主要的作用就是帮助我们进行分页的显示,通过配置一些默认参数,我们可以使得调用分页类只需要简单的几个参数,就可以显示出一个灵活多变,样式优美的分页。

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值