http://www.php.cn/php/php-getBy.html

根据字段名动态查询:getBy字段名( )

该方法很有意思,手册的说得很简略,我们根据源码来好好说道说道~~

1. 功能:根据字段值查询记录,且仅返回一条记录

2. 源码:/thinkphp/library/think/db/Query.php

您可能感到奇怪,我们不是在学习模型吗?怎么又折腾回了数据库了?原因很简单:这个动态查询是通过Query类的构造方法实现的:

  • Query.php 构造方法源码:
    /**
     * 利用__call方法实现一些特殊的Model方法
     * @access public
     * @param string $method 方法名称
     * @param array  $args   调用参数
     * @return mixed
     * @throws DbException
     * @throws Exception
     */public function __call($method, $args){if (strtolower(substr($method, 0, 5)) == 'getby') {// 根据某个字段获取记录$field         = Loader::parseName(substr($method, 5));$where[$field] = $args[0];return $this->where($where)->find();
        } elseif (strtolower(substr($method, 0, 10)) == 'getfieldby') {// 根据某个字段获取记录的某个值$name         = Loader::parseName(substr($method, 10));$where[$name] = $args[0];return $this->where($where)->value($args[1]);
        } else {throw new Exception('method not exist:' . __CLASS__ . '->' . $method);
        }
    }
  • 与getBy字段名( )相关的代码段:

注释是本人所加,源代码中并没有

  //去掉getBy获取字段名,并转为小写后,判断是否存在字段名字符串
  if (strtolower(substr($method, 0, 5)) == 'getby') {// 根据某个字段获取记录$field         = Loader::parseName(substr($method, 5));//将getBy***()的参数做为where方法的参数$where[$field] = $args[0];//返回查询结果:只返回单条满足条件的记录return $this->where($where)->find();

3. 实例演示:

  • 老规矩,先创建一个模型类:/application/index/mode/Staff.php
<?php
namespace app\index\model;//导入模型类use think\model;class Staff extends model {//自定义模型类代码}

一、任务1:查询姓名name等于"李云龙"的记录

  • 控制器:/application/index/controller/Index.php
<?phpnamespace app\index\controller;//导入模型类use app\index\model\Staff;class Index {  public function index(){  //1.获取name='李云龙'的【数据对象】
  $result = Staff::getByName('李云龙');  //2.获取数据对象原始数据
  $data = $result -> getData();   

  //3.查看结果
  dump($datas);  
  }
}
  • 查看结果:
array(7) {
  ["id"] => int(1011)
  ["name"] => string(9) "李云龙"
  ["sex"] => int(1)
  ["age"] => int(49)
  ["salary"] => float(10350)
  ["dept"] => int(1)
  ["hiredate"] => string(10) "2005-10-20"}

如果查询其它字段,只需要修改一下方法名称中的字段名部分即可,如查询年龄=30岁,方法名就是:getByAge(30)。因为方法名称因字段名称变化而变化,所以要动态查询。

二、任务2:查询姓名中含有:'大'字的员工信息

getBy字段名( )方法参数是否支持查询表达式呢?手册并未提及,但是看了源码后,发现有限支持:数组式查询表达式,如:[ 'between',[1010,1020] ] 或者:[ '>',1020 ]

  • 控制器:/application/index/controller/Index.php
<?phpnamespace app\index\controller;//导入模型类use app\index\model\Staff;class Index {  public function index(){  //1.获取name中包含"大"字符的记录,返回【数据对象】
  $result = Staff::getByName(['like','%大%']);  //2.获取数据对象原始数据
  $data = $result -> getData();   

  //3.查看结果
  dump($data);  
  }
}
  • 查看结果
array(7) {
  ["id"] => int(1024)
  ["name"] => string(9) "鲁大师"
  ["sex"] => int(0)
  ["age"] => int(60)
  ["salary"] => float(1300)
  ["dept"] => int(2)
  ["hiredate"] => string(10) "2012-09-09"}

4. 总结:

尽管动态查询方法的参数支持查询表达式,但不要比较或范围表达式,因为仅返回第一条满足条件记录,通常是没有意义的。模糊查询有时很有用,但同样也仅获取结果集的首条记录

建议用字段值,进行精准查询,不用要查询表达式。