ThinkPHP5数据库实例详解

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、参数与返回值

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

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

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 控制器代码如下：

<?php
namespace app\index\controller;

//导入数据库类
use think\Db;

class Index {
  public function index(){   
   $result = Db::table('tp5_staff')     // 设置数据表
          -> 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方法仍需要知道其基本用法，因为我们会在读其它程序员的源码时会遇到。