### 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(); ~~~ ### 模型支持表后缀以及动态切换 ~~~ <?php 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(); ``` ### 注解路由支持给某个路由指定所属分组 在注解中定义路由分组,可以使用 ~~~ <?php 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`的路由规则。你一样可以对该路由分组设置公共的参数,例如: ~~~ <?php 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`分组,也可以直接把某个路由加入该分组,例如: ~~~ <?php 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` 方法