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