Tags：Java开源框架 .NET开发框架 UI框架 PHP集成运行环境 PHP

ThinkPHP是目前最好用的兼容PHP开发框架，是你必备的PHP程序开发工具。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:facadeoptimize:model指令 改为扩展方式

取消命令行执行URL

删除Config类__get 和 __isset 方法