page方法

page方法

其实limit 方法完全可以实现分页查询 ，但是page提供了一种更加人性化的体验

1、功能：为分页查询提供更加直观的实现方法

2、源码：/thinkphp/library/think/db/Query.php

/** * 指定分页 * @access public * @param mixed $page 页数 * @param mixed $listRows 每页数量 * @return $this */ public function page($page, $listRows = null) { if (is_null($listRows) && strpos($page, ',')) { list($page, $listRows) = explode(',', $page); } $this->options['page'] = [intval($page), intval($listRows)]; return $this; }

看到源码是否觉得眼熟呢？对，与limit方法源码极其相似，区别在于给查询选择options[ 'page' ]赋值，limit是字符串，page是一个数组；

3、参数与返回值

• 参数很有意思，值得唠一唠

序号	参数	说明
1	$page / 数字 / 字符串	根据公式计算出来的当前页数，公式后面介绍
2	$listRows / 数字 / 字符串	每页显示的记录数量

• 返回值：仍然是当前查询对象本身。

4、实例演示

• 这里我们先以上节课学过的limit方法实现一下：

// 显示第一页数据 Db::table('tp5_staff') -> field('id,name,salary') -> limit(0,5) -> select(); // 显示第二页数据，只需要将起始位置由0，改为3即可 Db::table('tp5_staff') -> field('id,name,salary') -> limit(5,5) -> select(); // 以此类推，第三页 Db::table('tp5_staff') -> field('id,name,salary') -> limit(10,5) -> select();

规律(计算公式)：

• limit参数中，变化是的起始位置$offset，查询数量是不变的$listRows;
• $offset变化规律：（当前页码 - 1）* 每页显示数量 （这里假设为 5 ）
  
  • 如第1页的起始位置：（1-1）* 5 = 0 ，即 : limit( 0, 5);
  • 第2页的起始位置：（2-1）* 5 =5，即：limit( 5, 5);
  • 第3页的起始位置：（3-1）* 5 =10 , 即：limit( 10,5 );
  • 以下页，就依此类推即可。

• 明白了分页规律后，用page方法可以大简化这种操作，将上例改写：

// 显示第一页数据 Db::table('tp5_staff') -> field('id,name,salary') -> page(1,5) -> select(); // 显示第二页数据，只需要将起始位置由0，改为3即可 Db::table('tp5_staff') -> field('id,name,salary') -> page(2,5) -> select(); // 以此类推，第三页 Db::table('tp5_staff') -> field('id,name,salary') -> page(3,5) -> select();

page方法中第一个参数是显示页数，第二个是显示数量，这样一来，代码显示整洁直观。

• page方法可以只有一个参数：页数，此时，需要与limit方法配合工作

// 显示第一页数据,page方法参数为1，后面跟上limit方法设置显示数量 Db::table('tp5_staff') -> field('id,name,salary') -> page( 1 ) -> limit( 5 ) -> select(); // 显示第二页数据，page方法参数为2，后面跟上limit方法设置显示数量 Db::table('tp5_staff') -> field('id,name,salary') -> page( 2 ) -> limit( 5 ) -> select(); // 以此类推，第三页 Db::table('tp5_staff') -> field('id,name,salary') -> page( 3 ) -> limit( 5 ) -> select();

使用了page( 页数 ) -> limit( 数量 ) 语法，代码是不是更加的简洁、优雅了呢？

任务1：以每页5条记录方法，显示前三页数据（tp5_staff表）

• Index.php 控制器代码如下：

 field(['name' => '姓名','salary' => '工资']) // 设置显示的字段别名 -> page(2,5) //设置显示第二页，每页显示5条记录 ->select(); //生成结果集 //查看结果 dump($result); } }

• 查询结果如下：

array(5) { [0] => array(2) { ["姓名"] => string(9) "西门庆" ["工资"] => float(19801) } [1] => array(2) { ["姓名"] => string(9) "潘金莲" ["工资"] => float(8567) } [2] => array(2) { ["姓名"] => string(6) "宋江" ["工资"] => float(9261) } [3] => array(2) { ["姓名"] => string(9) "老顽童" ["工资"] => float(5000) } [4] => array(2) { ["姓名"] => string(9) "欧阳峰" ["工资"] => float(4900) } }

• 生成的SQL语句：

SELECT `name` AS `姓名`,`salary` AS `工资` FROM `tp5_staff` LIMIT 5,5

• 在SQLPRO FOR MySQL 中查看：

4、总结：

其实在开发，page方法用得较少，更多的是使用limit方法。但page方法仍需要知道其基本用法，因为我们会在读其它程序员的源码时会遇到。