本节课我们来学习模型中的用于封装的搜索器和数据结果集的操作。
1. 搜索器是用于封装字段(或搜索标识)的查询表达式,类似查询范围;
2. 一个搜索器对应模型的一个特殊方法,该方法为 public;
3. 方法名的命名规范为:searchFieldAttr();
4. 举个例子,我们要封装一个邮箱字符模糊查询,然后封装一个时间限定查询;
5. 在 User 模型端,我创建两个对外的方法,如下:
public function searchEmailAttr($query, $value, $data)
{
$query->where('email', 'like', $value.'%');
}
public function searchCreateTimeAttr($query, $value, $data)
{
$query->whereBetweenTime('create_time', $value[0], $value[1]);
}
6. 然后,在控制器端,通过 withSearch()方法实现模型搜索器的调用;
$result = UserModel::withSearch(['email', 'create_time'],[
'email'
=> 'xiao',
'create_time'
=> ['2014-1-1', '2017-1-1']
])->select();
7. withSearch()中第一个数组参数,限定搜索器的字段,第二个则是表达式值;
8. 如果想在搜索器查询的基础上再增加查询条件,直接使用链式查询即可;
UserModel::withSearch(...)->where('gender', '女')->select()
9. 如果你想在搜索器添加一个可以排序的功能,具体如下:
public function searchEmailAttr($query, $value, $data)
{
$query->where('email', 'like', $value.'%');
if (isset($data['sort'])) {
$query->order($data['sort']);
}
}
$result = UserModel::withSearch(['email', 'create_time'],[
'email'
=> 'xiao',
'create_time' => ['2014-1-1', '2017-1-1'],
'sort'
=> ['price'=>'desc']
])->select();
10. 搜索器的第三个参数$data,可以得到 withSearch()方法第二参数的值;
11. 字段也可以设置别名:'create_time'=>'ctime'
1. 数据集也是直接继承 collection 类,所以和数据库方式一样;
2. 数据集对象和数组操作方法一样,循环遍历、删除元素等;
3. 判断数据集是否为空,我们需要采用 isEmpty()方法;
$resut = UserModel::where('id', 111)->select();
if ($resut->isEmpty()) {
return '没有数据!';
}
4. 更多数据集方法,直接参考数据库那篇的表格即可;
5. 使用模型方法 hidden()可以隐藏某个字段,使用 visible()显示只某个字段;
6. 使用 append()可以添加某个获取器字段,使用 withAttr()对字段进行函数处理;
$result = UserModel::select();
$result->hidden(['password'])->append(['nothing'])->withAttr('email',
function ($value) {
return strtoupper($value);
});
return json($result);