ThinkPHP发布5.2RC1版本 · ThinkPHP官方博客

### 2019 年 2 月 14 日发布 `5.2`在经过几个月的测试版本迭代后，正式进入候选版本。之后的重点工作会是扩展以及文档的完善。当然，不排除核心还有微调的可能。 ThinkPHP5.2`RC1`版本继上个版本[`beta3`版本](https://blog.thinkphp.cn/934993)发布以来，主要更新如下： ## 新特性 ### 支持`FIND_IN_SET`查询增加了新的查询表达式对`FIND_IN_SET`的支持，使用下面的查询即可： ``` Db::name('user')->where('group_list', 'find in set', 2)->select(); ``` ### 增加了分区查询支持增加了对分区的支持（需要MySQL`5.6+`版本），例如你对`user`表分了`p1`和`p2`两个分区，你可以使用下面的查询： ``` Db::name('user')->partition('p1')->insert(['name' => 'think']); Db::name('user')->partition(['p1', 'p2'])->select(); Db::name('user')->partition(['p1', 'p2'])->where('name', 'think')->update(['name' => 'thinkphp']); Db::name('user')->partition('p1')->where('name', 'think')->delete(); ``` ### 增加了`ON DUPLICATE UPDATE`支持支持`ON DUPLICATE UPDATE`，例如： ``` Db::name('user')->duplicate(['score' => 10])->insert(['name' => 'think']); ``` ### 增加`extra`方法设置查询额外参数 `extra`方法可以用于`CURD`查询，例如： ``` Db::name('user')->extra('IGNORE')->insert(['name' => 'think']); Db::name('user')->extra('DELAYED')->insert(['name' => 'think']); Db::name('user')->extra('SQL_BUFFER_RESULT')->select(); ``` 新增单个数据改为使用更清晰和高效的`INSERT SET`语法，例如下面的查询 ``` Db::name('user')->insert(['name' => 'think', 'score' => 100]); ``` 实际生成的SQL语句是 ``` INSERT INTO user SET `name` = 'think', `score` = 100 ``` ### 增加`whereFieldRaw`查询方法该方法用于对字段使用SQL函数查询，例如： ``` User::whereFieldRaw('date_format("create_time", "%Y")', '2019')->select(); User::whereFieldRaw('date_format("create_time", "%Y")', '>', '2018')->select(); ``` ### `Query`类的`update`方法支持获取模型的更新条件现在可以直接使用模型的查询条件作为`Db`类`update`方法的数据更新条件，例如： ``` $user = User::find(1); $user->field(['name'])->update(['name' => 'thinkphp']); ``` ### 数据集类增加快捷查询（过滤）方法 `think\Collection`类增加`whereLike`/`whereNotLike`/`whereIn`/`whereNotIn`/`whereBetween`/`whereNotBetween`等快捷方法，用于更方便的进行数据筛选而替代使用不够直观的`where`方法。 ### 增加`optimize:facade`指令可以在本地开发的时候使用该指令为`Facade`类生成对应类的方法注释。你只需要在定义Facade类的时候，在类的注释中添加 `@mixin` 选项，例如使用`@mixin think\Db`注释后，使用`optimize:facade`指令后，就会在类的注释中自动生成`think\Db`类的相关`public`方法注释，方便IDE自动提示，每个类的方法返回值类型最好明确指定（没有返回值的则使用`void`），否则注释中会使用`mixed`返回类型。 ### 增加新的表达式查询解析扩展增加了新的`think\db\Expression`类（原来的`Expression`类已经更改为`Raw`类）用于查询表达式的扩展解析，你只需要自定义一个表达式解析类，例如： ``` <?php namespace app\common\expression; use think\db\Expression; class Rlike extends Expression { /** * 分析查询表达式 * * @param Query $query 查询对象 * @param string $key * @param string $exp * @param string $field * @param integer $bindType * @return string */ public function parse(Query $query, string $key, string $exp, string $field, int $bindType): string { if ($this->value instanceof Raw) { $value = $this->value->getValue(); } else { $value = $this->value; } return $key .' RLIKE ' . $value ; } } ``` 现在我们就可以使用下面的查询语法了： ``` User::where('name', 'rlike', new \app\common\expression\Rlike('^think'))->select(); ``` ### 提供了关闭事件机制的方法如果你完全不需要使用事件机制，可以在入口文件中使用`withEvent`方法关闭事件功能。 ``` (new App())->withEvent(false)->run()->send(); ``` >[danger] 不过值得提醒的是，新版的路由功能、多语言支持和请求缓存功能都是利用了事件机制响应的。 ## 用法调整 ### 原来`Query`类的`raw`方法移动到`Db`类虽然用法上没有改变，但`Db::raw()`方法的调用效率会更高一些。或者你可以直接使用新的助手函数`raw`替代`Db::raw`。 ### 原来的`Expression`类改为`Raw`类原来的`think\db\Expression`类更改为`think\db\Raw`类，更加贴切。 ### 多对多关联的`pivotDataName`方法更名为`name`方法使用更加简洁的`name`方法替代原来的`pivotDataName`方法。 ## 废弃用法和参数 ### 取消`Query`类的`extend`方法取消了`Query`类的`extend`方法，如果需要扩展查询方法，建议自定义`Query`类并继承系统的`think\db\Query`类即可，然后在模型中定义`query`属性或者配置数据库连接的`query`参数为你的自定义类。 ### 取消`Request`类的`hook`方法由于不建议扩展`Request`类的方法，该方法已经在最新版本中取消。 ### 取消`URL`参数模式配置原来的URL参数模式配置参数`url_param_type`，统一使用参数/值的方式。 ## 更新日志 * 改进Url类`build`方法 * 修复获取当前页码数据类型 * 修正`parseKey`方法传入数值的情况 * 改进`optimize:config`指令对`declare`申明的支持 * 取消URL参数模式配置 * 增加`optimize:facade`指令用于生成`facade`类的方法注释 * 取消`Query`类的`extend`方法 * 原来的`Expression`类更改为`Raw`类 * 增加新的`Expression`类用于表达式查询扩展 * `Collection`类增加`whereLike`/`whereNotLike`/`whereIn`/`whereNotIn`/`whereBetween`/`whereNotBetween`等快捷方法 * Query类的`raw`方法移动到Db类 * 取消`Request`类的`hook`方法 * 修正`Route::view`方法 * 优化模型获取器方法 * 多对多关联的`pivotDataName`方法更名为`name`方法 * Query类增加`partition`/`duplicate`/`extra`方法 * 改进mysql驱动支持分区和`duplicate`以及额外参数 * mysql驱动的`insert`方法改用更清晰的`insert set`语法 * 修正`Event`类`bind`属性定义 * 修正验证类的`append`一处bug * 改进`Query`类`update`方法支持读取模型的更新条件 * 取消模型类的`getUpdateWhere`方法统一使用`getWhere`方法 * 改进query类的`fetchArray`方法处理 * 改进路由类取消`app`属性 * 增加`think\facade\RuleName`类 * 增加`whereFieldRaw`查询方法 * 改进自动多应用名称获取 * App类增加`withEvent`方法支持关闭事件机制 * 改进`Dispatch`类对`var_dump`的支持 * 改进`hasMany`的`withCount`自关联 * 修正纯数字检测参数类型转换问题 * 修正`raw`助手函数 * `mysql`支持`find_in_set`查询 * 改进`url`方法对自动多应用的支持