php越来越完善1031无标题,ThinkPHP6.0RC3版本发布——细节完善，体验优化

### 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` 方法