ThinkPHP5.1.26版本发布 —— 修正版本,包含安全更新
该版本主要修正了上一个版本的一些问题,并改进了全局查询范围的支持,同时包含了一个安全更新,支持上一个版本的无缝升级。
主要更新
-
修正单一模块下注解路由无效的问题
-
改进数据库的聚合查询的字段处理
-
模型类增加
1globalScope属性定义 用于指定全局的查询范围
-
模型的
1useGlobalScope方法支持传入数组 用于指定当前查询需要使用的全局查询范围
-
改进数据集的
1order方法对数字类型的支持
-
修正上一个版本
1order方法解析的一处BUG
-
排序字段不合法或者错误的时候抛出异常
-
改进
1Request类的
1file方法对上传文件的错误判断
安全更新
本次发布的版本,包含了一个数据库聚合查询的安全更新。
如果你在使用聚合查询的时候,聚合查询的字段名由用户输入决定,可能会引发SQL注入,你应该尽快更新到新版本以解决安全隐患(感谢补天平台反馈,漏洞编号
1 | QTVA-2018-875147 |
)。
新特性介绍
排序字段不合法抛出异常
之前如果有非法的排序字段会直接忽略,新版会抛出一个异常。
User::order('rand()')->select();
会抛出异常
排序表达式错误:rand()
正确的写法应该是
User::orderRaw('rand()')->select();
数据集的
1
order
方法改进
1 | order |
数据集的
1 | order |
方法现在可以更好的支持数字类型的数据排序,
1 | order |
方法的第三个参数可以指定是否为数字类型(默认为数字类型进行排序)。
// 查询用户列表 $users = User::where('status', 1)->select(); // 对用户列表按照score字段降序排列 $list = $users->order('score', 'desc');
如果是需要对字符串类型的字段排序,可以使用
// 查询用户列表 $users = User::where('status', 1)->select(); // 对用户列表按照name字段升序排列 $list = $users->order('name', 'asc', false);
全局查询范围改进
全局查询范围之前必须通过
1 | base |
方法来定义,现在可以使用在
1 | globalScope |
属性中定义查询范围的名称,
<?php namespace app\index\model; use think\Model; class User extends Model { // 定义全局的查询范围 protected $globalScope = ['status']; protected function scopeStatus($query) { $query->where('status',1); } }
或者使用
1 | useGlobalScope |
方法传入数组的方式动态指定当前查询的全局查询范围。
User::useGlobalScope(['status'])->select();
1 | useGlobalScope |
方法的数据会覆盖
1 | globalScope |
属性定义,但如果传入空的数组,则仍然会获取
1 | globalScope |
属性定义的全局查询范围。
1
Request
类的
1
file
方法改进
1 | Request |
1 | file |
如果你要获取的上传文件有任何的上传错误情况,系统会抛出一个异常,而不是返回一个
1 | Null |
。
try { $image = $request->file('image'); } catch (\Exception $e){ // 上传发生错误 echo $e->getMessage(); }
如果你获取全部的上传文件信息的话,即使包含上传错误的数据,也不会抛出异常,错误的上传数据会被忽略。
// 如果image上传存在错误,则不会包含在files信息里面 // 如果不希望如此结果,可以首先进行上传验证或者单独获取某个上传文件 $files = $request->file();