where方法

where 方法

1. 功能:生成查询条件(AND)

where方法是查询构造器的核心,是整个数据表查询的精华所在,也是ThinkPHP 5 与之前版本区别最大的地方之一,请一定要认真学习,理解透彻!

2. 源码:

1、/thinkphp/library/think/db/Query.php

  • where 和 whereOr 方法源码:
/**
     * 指定AND查询条件
     * @access public
     * @param mixed $field     查询字段
     * @param mixed $op        查询表达式
     * @param mixed $condition 查询条件
     * @return $this
     */
    public function where($field, $op = null, $condition = null)
    {
        $param = func_get_args();  //获取参数列表数组
        array_shift($param);  //删除第一个元素
        $this->parseWhereExp('AND', $field, $op, $condition, $param);
        return $this;
    }

分析:

  1. 首先用func_get_args函数获取到全部参数,打包到一个索引数组中;
  2. 再用array_shift函数使参数数组中的第一个元素出列,即单独取出:字段名;
  3. parseWhereExp方法根据逻辑关系来解析上面全部参数,将结果传到字段名;
  4. 获取完整查询条件后,再次返回查询对象本身,继续调用后台连贯方法。
    本例提到的二个PHP函数如果记不清了,请先复习一下或上网查一下

3、参数与返回值

  • 方法原型:
    /**
     * 指定AND查询条件
     * @access public
     * @param mixed $field     查询字段
     * @param mixed $op        查询表达式
     * @param mixed $condition 查询条件
     * @return $this
     */
 public function where($field, $op = null, $condition = null)
  • 描述:where( 字段名,表达式,查询条件);

  • 参数

序号 参数 说明
1 $field:查询字段 必须是表中存在的字段,支持别名
2 $op:查询表达式 算术、逻辑、比较运算符
3 $condition:查询条件 字符串、数值、数组等
  • 返回值:与其它连贯方法一样,返回查询对象本身(Query对象)

4、适合环境:可连续调用多次,多条件之间为逻辑与(AND)关系


5、实例:

再次回顾:where( 字段名 ,表达式,条件)
查询表达式,我们先以最简单的字符串方式来举例,更高级用法下节课讲

  • 实例演示前,我们先看看tp5_staff表中数据情况:

任务1 :查询表中dept=1的员工信息

  • Index.php 控制器代码:
<?php
namespace app\index\controller;

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

class Index {
  public function index(){

    //查询 dept(部门)等于 1 的员工信息
    $result = Db::table('tp5_staff')   // 设置数据表
            -> field('id,name,dept')    // 设置结果集中允许显示的字段
            -> where('dept = 1')      // 设置查询条件
            -> select();   // 获取结果集

    //查看结果
    dump($result);
   }
 }
  • 查询结果如下:
array(4) {
  [0] => array(3) {
    ["id"] => int(1011)
    ["name"] => string(9) "李云龙"
    ["dept"] => int(1)
  }
  [1] => array(3) {
    ["id"] => int(1024)
    ["name"] => string(9) "鲁大师"
    ["dept"] => int(1)
  }
  [2] => array(3) {
    ["id"] => int(1027)
    ["name"] => string(9) "程序员"
    ["dept"] => int(1)
  }
  [3] => array(3) {
    ["id"] => int(1028)
    ["name"] => string(6) "方方"
    ["dept"] => int(1)
  }
}

任务2:查询表中dept=1,并且 sex =1 的员工信息

这比上例多了一个限制条件,并且是“逻辑与”(AND)关系,必须全部满足条件才可以

  • Index.php 控制器代码:
<?php
namespace app\index\controller;

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

class Index {
  public function index(){

    //查询 dept(部门)等于 1 的员工信息
    $result = Db::table('tp5_staff')   // 设置数据表
            -> field('id,name,dept')    // 设置结果集中允许显示的字段
            -> where('dept = 1')      // 设置查询条件dept =1
            -> where('sex = 1')     //  设置查询条件 sex = 1 逻辑AND关系
            -> select();   // 获取结果集

    //查看结果
    dump($result);
   }
 }
  • 查询结果如下:
array(2) {
  [0] => array(3) {
    ["id"] => int(1011)
    ["name"] => string(9) "李云龙"
    ["dept"] => int(1)
  }
  [1] => array(3) {
    ["id"] => int(1027)
    ["name"] => string(9) "程序员"
    ["dept"] => int(1)
  }
}

由此可见:where方法支持连续调用,每一次调用生成的查询条件之间是:逻辑与的关系

  • 生成SQL:
SELECT `id`,`name`,`dept` FROM `tp5_staff` WHERE ( dept = 1 ) AND ( sex = 1 )