### 2019 年 6 月 3 日 发布
RC3版本主要改进和优化了系统内置中间件,改进了一些用法和体验,并且把不常用的驱动移出核心改为扩展方式提供。
## 主要新特性
### 增加`whereWeek`日期查询
~~~
// 查询本周文章
Article::whereWeek('create_time')->select();
// 查询上周文章
Article::whereWeek('create_time', 'last week')->select();
// 查询2019-1-1到2019-1-7的文章
Article::whereWeek('create_time', '2019-1-1')->select();
~~~
### 自增ID获取支持类型自动转换
自增ID获取的时候会根据主键的字段类型自动转换处理,而不是PDO默认返回的字符串类型。
### 当前请求记录匹配路由规则
记录当前请求的路由规则对象,可以通过
~~~
$request->rule();
~~~
获取当前请求实际匹配的路由规则对象
### 增加`requireWithout`验证规则
表示当某个字段没有数据的时候必须,可以组合完成表单中某两个字段必须填写一项的验证,例如:
~~~
'phone' => 'requireWithout:mobile',
'mobile'=> 'requireWithout:phone',
~~~
优化路由ext和name方法以及URL生成
### 增加项目自定义类
取消了内置的`think\Controller`控制器基类,在项目中提供了`app\BaseController`控制器基类更方便自定义。
另外项目还提供了`app\Request`自定义请求类,可以自定义应用所需的请求方法和属性。提供了`app\ExceptionHandle`自定义异常处理类,方便对异常进行自定义接管处理。
### URL生成使用对象方式操作
Route类`buildUrl`及`url`助手函数返回类型改为`think\route\Url`对象实例而不是字符串,由于定义了`__toString`方法,因此可以在模板中直接输出为URL字符串。
~~~
echo url('index/hello',['name'=>'think'])->suffix('htm')->domain('blog');
~~~
### 修改器改进
改进修改器方法支持不返回任何数据,而是在修改器中直接设置数据
例如:
~~~
class User extends \think\Model
{
public function setField1Attr($value,$data){
$this->set('field2', $data['field2']);
$this->set('field3', $data['field3']);
}
}
$user = new User;
$user->field1 = 'value1';
$user->save();
~~~
实际写入数据库的时候不会包含`field1`字段数据,但会包含`field2`和`field3`的数据。
### `dump`/`halt`助手函数调整支持输出多个变量
你可以使用
~~~
dump($var1,$var2,...)
~~~
方式输出多个变量调试,同样`halt`方法也可以支持调试多个变量输出并中止执行。
最新版本会在安装项目的时候安装`symfony/var-dumper`扩展替换内置的`dump`助手函数,因此你可以进行更强大的输出
### 关联自动更新
关联`together`方法自动更新和删除的时候可以无需使用`with`
例如,之前的写法
~~~
$article = Article::with('comments')->find(1);
$article->together(['comments'])->delete();
~~~
现在可以直接写成
~~~
$article = Article::find(1);
$article->together(['comments'])->delete();
~~~
### 模型数据集增加`delete`和`update`方法
可以批量对数据集进行更新和删除操作(支持模型事件)
~~~
// 更新今天的数据
$list = Article::whereDay('create_time')->select();
$list->update(['is_new'=>1]);
// 删除昨天的数据
$list = Article::whereDay('create_time', 'yesterday')->select();
$list->delete();
~~~
### 模型支持表后缀以及动态切换
~~~
namespace app\model;
use think\Model;
class Blog extends Model
{
// 定义默认的表后缀(默认查询中文数据)
protected $suffix = _cn';
}
~~~
模型提供了动态切换方法`switch`和`setSuffix`,例如:
```
// switch方法用于静态查询
Blog::switch('_en')->find();
// setSuffix用于动态设置
$blog = new Blog($data);
$blog->setSuffix('_en')->save();
```
### 注解路由支持给某个路由指定所属分组
在注解中定义路由分组,可以使用
~~~
namespace app\controller;
/**
* @group('blog')
*/
class Blog
{
/**
* @param string $name 数据名称
* @return mixed
* @route('hello/:name','get')
*/
public function hello($name)
{
return 'hello,'.$name;
}
}
~~~
当前控制器中的注解路由会自动加入`blog`分组下面,最终,会注册一个`blog/hello/:name`的路由规则。你一样可以对该路由分组设置公共的参数,例如:
~~~
namespace app\controller;
/**
* @group('blog')->ext('html')
* ->pattern(['id' => '\d+', 'name' => '\w+'])
*
*/
class Blog
{
/**
* @param string $name 数据名称
* @return mixed
* @route('hello/:name','get')
*/
public function hello($name)
{
return 'hello,'.$name;
}
}
~~~
如果你已经在路由定义文件中定义了`blog`分组,也可以直接把某个路由加入该分组,例如:
~~~
namespace app\controller;
class Blog
{
/**
* @param string $name 数据名称
* @return mixed
* @route('hello/:name','get')->group('blog')
*/
public function hello($name)
{
return 'hello,'.$name;
}
}
~~~
### 多语言支持分组定义
你可以在定义多语言的时候使用分组定义
~~~
return [
'user' => [
'welcome' => '欢迎回来',
'login' => '用户登录',
'logout' => '用户登出',
]
];
~~~
然后使用下面的方式获取多语言变量
~~~
Lang::get('user.login');
lang('user.login');
~~~
### 支持自定义加载语言文件
可以通过`extend_list`设置,例如:
~~~
'extend_list' => [
'zh-cn' => [
app()->getBasePath() . 'lang\zh-cn\app.php',
app()->getBasePath() . 'lang\zh-cn\core.php',
],
]
~~~
便于在扩展中自定义语言包,并且现在已经支持语言文件使用`YML`格式定义
### 缓存标签改进
增加`TagSet`类,`tag`方法支持传入数组,同时对多个标签进行操作
~~~
Cache::tag('tag')->set('name1','value1');
Cache::tag('tag')->set('name2','value2');
// 清除tag标签的缓存数据
Cache::tag('tag')->clear();
~~~
并支持同时指定多个缓存标签操作
~~~
Cache::tag(['tag1', 'tag2'])->set('name1', 'value1');
Cache::tag(['tag1', 'tag2'])->set('name2', 'value2');
// 清除多个标签的缓存数据
Cache::tag(['tag1','tag2'])->clear();
~~~
可以追加某个缓存到标签
```
Cache::tag('tag')->append('name3');
```
### 缓存类增加`push`方法
增加元素到一个数组缓存
```
Cache::set('name', [1,2,3]);
Cache::push('name', 4);
Cache::get('name'); // [1,2,3,4]
```
### Cookie保存时间支持DateTimeInterface
### 增加表单令牌中间件
### 控制器支持__call方法
### 增加`deny_app_list`配置参数
可以配置禁止直接访问的应用列表
### 控制器中间件改进
控制器中间件的`only`和`except`定义不区分大小写
### `app_map`支持指定泛应用映射
可以在`app_map`配置中定义泛应用解析到指定应用,例如:
~~~
'app_map' => [
'think' => 'admin', // 把admin应用映射为think
// ... 其它应用映射定义
'*' => 'home', // 其它应用解析到home
],
~~~
## 问题修正
* 修正参数绑定的浮点型精度问题
* 修正软删除
* 修正模型的数据库连接
* 修正`RedirectResponse`
* 修正Session类`flush`方法
* 修正JSON字段参数绑定
* 修正`make:controller`指令生成
* 修正Cache类的`get`方法默认值
* 修正域名绑定
* 修正关联模型的动态获取器
* 修正模型`dateFormat`属性方法
* 修正url生成对多入口的支持
* 修正ini配置文件格式的布尔值转换问题
* 修正路由延迟解析全局配置无效的问题
* 修正路由缓存问题
* 修正关联`update`操作
* 修正`Relation::$selfRelation`默认为`null`,导致`Relation::isSelfRelation()`方法报错
* 修正`redis`缓存驱动
* 修正事件智能订阅`observe`方法
* 修正模型字段定义对日期查询无效的问题
* 修正Console类`getNamespaces`方法
* 修正`where`查询方法传入Query对象的时候缺少`bind`数据的问题
* 修正request类`method`方法
* 修正`route:list`指令
* 修正`Collection`类`load`方法
* 修正`redis`驱动的端口类型
* 修正`session`数据序列化使用JSON处理的问题
* 修正分组路由合并解析
* 修正模型的`hidden`方法隐藏关联模型的问题
* 修正关联查询关联键为空的错误
* 修正返回204状态码的响应判断
* 修正`Request`类`has`方法对`env`和`session`的支持
* 修正`provider.php`文件无效问题
* 修正关联查询的部分问题
* 修正`validate`助手函数支持指定验证器类
* 修正验证类`getValidateType`方法
* 修正入口单独开启调试模式
* 修正加载`Composer`应用
## 用法调整
* 页面`trace`中间件仅在调试模式有效,并且无需设置环境变量
* `Socket`日志驱动移出核心
* `PostgreSQL`、`Sqlite`和`SqlServer`驱动移出核心,改为扩展
* 取消内置`think\Controller`基类
* `Yaconf`支持移出核心 纳入扩展`think-yaconf`
* 字段排除改为`withoutField`方法
* 取消`useGlobalScope`方法增加`withoutGlobalScope`方法
* 更改默认生成的中间件位置
* 加载默认语言包无需开启多语言中间件
* `Cookie`类恢复`get`和`has`方法支持
* `token`助手函数调整
* 全局请求缓存参数调整
* 统一中间件调用传参,不支持`:`分割传参
* 缓存数据统一进行序列化后存储
* `Cache`类`rm`方法更改为`delete`方法
* `validate`助手函数返回`Validate`对象实例而不是数据验证
## 废弃用法
* 取消多语言的`auto_detect`配置
* 取消`session`类的`auto_start`配置参数和`boot`方法
* 废弃`Where`数组对象查询
* 取消模型事件观察者
* 取消`JumpResponse`及`success`/`error`/`result`等方法和助手函数
* 取消表达式查询解析扩展及`think\db\Expression`类
* 废弃模型自动完成功能,使用模型事件替代
* 取消`cookie`的`prefix`参数
* 取消一系列不推荐使用的助手函数
* 取消`optimize:facade` `optimize:model`指令 改为扩展方式
* 取消命令行执行URL
* 删除`Config`类`__get` 和 `__isset` 方法