### 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`类)用于查询表达式的扩展解析,你只需要自定义一个表达式解析类,例如:
```
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`方法对自动多应用的支持