limit方法

limit方法

1、功能：限制查询结果集输出的数量

limit方法常用在分页显示用，对于记录较多的数据表，限制每次输出数量，很有必要

2、源码：直接贴上，不再附图

/**
     * 指定查询数量
     * @access public
     * @param mixed $offset 起始位置
     * @param mixed $length 查询数量
     * @return $this
     */
    public function limit($offset, $length = null)
    {
        if (is_null($length) && strpos($offset, ',')) {
            list($offset, $length) = explode(',', $offset);
        }
        $this->options['limit'] = intval($offset) . ($length ? ',' . intval($length) : '');
        return $this;
    }

源码分析：

• 先判断$length是否存在？如果为NULL，则把$offset用逗号切割为二个变量：$offset,$length；
• 拼接查询条件，为防止参数错误用了取整函数intval( )，最后将条件赋值给对象的查询选项属性opptions['limit']

3、参数与返回值

• 参数

• 返回值：当然还是当前查询对象自身。

4、实例演示：

limit 方法非常简单，但又非常重要，特别是在数据分页显示时

任务1：显示tp5_staff表中工资最高的3个员工信息

该实例很简单，将表中数据按工资降序排列，仅输出前三个记录即可

• Index.php  控制器代码

<?php
namespace app\index\controller;
//导入数据库类
use think\Db;

class Index {
  public function index(){   
   $result = Db::table('tp5_staff')    // 设置数组表tp5_staff
          -> field(['name' => '姓名','salary' => '工资'])  // 仅显示姓名和工资，用别名
          -> order(['salary' => 'desc'])  // 按工资降序由高到底排列
          -> limit(3)   // 仅显示前三条记录，即工资最高的员工
          // -> limit( '3' )  //用字符串也可以，limit 会自动转换为数值型
          ->select();      // 返回结果集

    //查看结果
    dump($result);
  }
}

• 输出结果：

array(3) {
  [0] => array(2) {
    ["姓名"] => string(9) "西门庆"
    ["工资"] => float(19801)
  }
  [1] => array(2) {
    ["姓名"] => string(6) "方方"
    ["工资"] => float(9877)
  }
  [2] => array(2) {
    ["姓名"] => string(9) "李云龙"
    ["工资"] => float(9850)
  }
}

• 对应的SQL 语句：

SELECT `name` AS `姓名`,`salary` AS `工资` FROM `tp5_staff` ORDER BY `salary` desc LIMIT 3

• 将SQL语句复制到 SQLPRO 中运行
  

还有西门大官人有钱呀，怪不得金莲会爱上他呀 ~~~

任务2：显示tp5_staff表中工资中，第5到第7名的员工信息

本例用到了偏移量（即查询记录的索引起始值），记录索引从0开始计数，第5名的起始位置为4；

• Index.php  控制器代码

<?php
namespace app\index\controller;
//导入数据库类
use think\Db;

class Index {
  public function index(){   
   $result = Db::table('tp5_staff')    // 设置数组表tp5_staff
          -> field(['name' => '姓名','salary' => '工资'])  // 仅显示姓名和工资，用别名
          -> order(['salary' => 'desc'])  // 按工资降序由高到底排列
          -> limit(4,3)   // 因为从0开始计数，所以4代表起始位置为第5条记录，
          // -> limit( '4, 3' )  // 用字符串也可以，limit 会自动转换为数值型
          ->select();      // 返回结果集

    //查看结果
    dump($result);
  }
}

• 输出结果：

array(3) {
  [0] => array(2) {
    ["姓名"] => string(6) "宋江"
    ["工资"] => float(9261)
  }
  [1] => array(2) {
    ["姓名"] => string(9) "潘金莲"
    ["工资"] => float(8567)
  }
  [2] => array(2) {
    ["姓名"] => string(6) "梦姑"
    ["工资"] => float(6765)
  }
}

• 对应的SQL 语句

SELECT `name` AS `姓名`,`salary` AS `工资` FROM `tp5_staff` ORDER BY `salary` desc LIMIT 4,3

• SQLPRO 中运行结果如下：

5、总结

limit 方法，更多是配合page方法在使用，我们下节课讲page方法还会提及