RC3版本主要改进和优化了系统内置中间件,改进了一些用法和体验,并且把不常用的驱动移出核心改为扩展方式提供。
主要新特性
增加whereWeek 日期查询
Article::whereWeek('create_time')->select();
Article::whereWeek('create_time', 'last week')->select();
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 ,例如:
Blog::switch('_en')->find();
$blog = new Blog($data);
$blog->setSuffix('_en')->save();
注解路由支持给某个路由指定所属分组
在注解中定义路由分组,可以使用
<?php
namespace app\controller;
class Blog
{
public function hello($name)
{
return 'hello,'.$name;
}
}
当前控制器中的注解路由会自动加入blog 分组下面,最终,会注册一个blog/hello/:name 的路由规则。你一样可以对该路由分组设置公共的参数,例如:
<?php
namespace app\controller;
class Blog
{
public function hello($name)
{
return 'hello,'.$name;
}
}
如果你已经在路由定义文件中定义了blog 分组,也可以直接把某个路由加入该分组,例如:
<?php
namespace app\controller;
class 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',
'*' => '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 方法
|