ThinkPHP 6.0 RC 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 助手函数调整
• 全局请求缓存参数调整
• 统一中间件调用传参，不支持 : 分割传参
• 缓存数据统一进行序列化后存储

废弃用法

• 取消多语言的 auto_detect 配置
• 取消 session 类的 auto_start 配置参数和 boot 方法
• 废弃 Where 数组对象查询
• 取消模型事件观察者
• 取消 JumpResponse 及 success / error / result 等方法和助手函数
• 取消表达式查询解析扩展及 think\db\Expression 类
• 废弃模型自动完成功能，使用模型事件替代
• 取消 cookie 的 prefix 参数
• 取消一系列不推荐使用的助手函数
• 取消 optimize:facade optimize:model 指令 改为扩展方式
• 取消命令行执行URL
• 删除 Config 类 __get  和  __isset  方法