[where]
where方法的参数支持字符串和数组,虽然也可以使用对象但并不建议。
-
字符串条件
使用字符串条件直接查询和操作
$User = M("User"); // 实例化User对象
$User->where('type=1 AND status=1')->select();
如果使用3.1以上版本的话,使用字符串条件的时候,可以配合预处理机制,确保更加安全。
$Model->where("id=%d and username='%s' and xx='%f'",$id,$username,$xx)->select(); -
数组条件
普通查询
$User = M("User"); // 实例化User对象
$map['name'] = 'thinkphp';
$map['status'] = 1;
$User->where($map)->select();
表达式查询(EQ、NEQ、GT、EGT、LT、ELT、LIKE、BETWEEN、NOT BETWEEN、IN、NOT IN)
$map['字段1'] = array('表达式','查询条件1');
$map['字段2'] = array('表达式','查询条件2');
$Model->where($map)->select(); -
多次调用
3.1.3版本开始,where方法支持多次调用,但字符串条件只能出现一次。
$map['a'] = array('gt',1);
$where['b'] = 1;
$Model->where($map)->where($where)->where('status=1')->select();
[field]
field方法属于模型的连贯操作方法之一,主要目的是标识要返回或者操作的字段,可以用于查询和写入操作。
-
用于查询
field方法指定了查询的结果集中包含id,title,content三个字段的值。
$Model->field('id,title,content')->select();
可以给某个字段设置别名。
$Model->field('id,nickname as name')->select();
可以在field方法中直接使用函数,例如sum函数。
$Model->field('id,SUM(score)')->select();
使用数组参数,执行效果和前面的一样。
$Model->field(array('id','title','content'))->select();
数组方式的定义可以为某些字段定义别名。
$Model->field(array('id','nickname'=>'name'))->select(); -
字段排除
field可以带true参数,表示排除第一个参数里面的字段。
获取除了content之外的所有字段。
$Model->field('content',true)->select();
排除多个字段
$Model->field('user_id,content',true)->select();
$Model->field(array('user_id','content'),true)->select(); -
用于写入合法性检查
field方法结合create方法使用就可以完成表单提交的字段合法性检测,多余数据会过滤掉。
$Model->field('title,email,content')->create();
[order]
支持对多个字段的排序,如果没有指定desc或者asc排序规则的话,默认为asc。
$Model->where('status=1')->order('id desc,status')->limit(5)->select();
如果字段和mysql关键字有冲突,可以采用数组方式调用。
$Model->where('status=1')->order(array('order','id'=>'desc'))->limit(5)->select(); //排序字段为为order和id
[page]
虽然利用limit方法可以达到分页效果,但是需要计算起始位置,page方法会自动计算。
$Article = M('Article');
$Article->page('1,10')->select(); // 查询第一页数据
$Article->page('2,10')->select(); // 查询第二页数据
3.1版本以后,page方法也支持2个参数的写法。
$Article->page(1,10)->select();
page方法还可以和limit方法配合使用。
$Article->limit(25)->page(3)->select();
当page方法只有一个值传入的时候,表示第几页,而limit方法则用于设置每页显示的数量,也就是说上面的写法等同于:
$Article->page('3,25')->select();
[group]
group方法只有一个参数,并且只能使用字符串。
查询结果按照用户id进行分组统计。
$this->field('username,max(score)')->group('user_id')->select();
也支持对多个字段进行分组。
$this->field('username,max(score)')->group('user_id,test_time')->select();
注意:如果group之前不加任何函数操作的话,group之后,每一个分组只会返回第一条数据。
[having]
用于配合group方法完成从分组的结果中筛选。
having方法只有一个参数,并且只能使用字符串。
$this->field('username,max(score)')->group('user_id')->having('count(test_time)>3')->select();
[distinct]
返回唯一不同的值,distinct方法的参数是一个布尔值。
$Model->distinct(true)->field('name')->select();
[cache]
cache可以用于select、find和getField方法,以及其衍生方法。
对find方法使用cache方法,第一次查询结果会被缓存,第二次查询相同的数据的时候就会直接返回缓存中的内容,而不需要再次进行数据库查询操作。
$Model = M('User');
$Model->where('id=5')->cache(true)->find();
默认情况下, 缓存有效期和缓存类型是由DATA_CACHE_TIME和DATA_CACHE_TYPE配置参数决定的,但cache方法可以单独指定。
$Model = M('User');
$Model->cache(true,60,'xcache')->find();
cache方法可以指定缓存标识。
$Model = M('User');
$Model->cache('key',60)->find();
外部可以通过S方法直接获取查询缓存的数据。
$Model = M('User');
$result = $Model->cache('key',60)->find();
$data = S('key');
[strict]
strict为3.2.3新增连贯操作,用于设置数据写入和查询是否严格检查是否存在字段。默认情况下不合法数据字段自动删除,如果设置了严格检查则会抛出异常。
$model->strict(true)->add($data);
如果User表里面没有test字段,执行如下语句就会报错。
$Model = M('User');
$data['test'] = 'test';
$result = $Model->strict(true)->add($data);