Releases: top-think/framework
Releases · top-think/framework
V6.0.0RC3
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方法
V5.1.37.1
V5.1.37
V5.1.36
V6.0.0RC2
主要更新
主要更新如下：
- 底层架构针对协程做优化调整
- 增加WEB应用管理类
Http - 增加应用初始化服务和服务注册机制
- 查询事件和模型事件使用事件系统接管
Session类重构，不再使用PHP内置会话Cookie类仅支持设置和写入，不再支持读取- 取消
Config类的动态设置功能 - 部分核心功能中间件化（页面Trace、多语言、请求缓存和Session初始化）
- 取消惯例配置文件
- 增加驱动接口规范驱动开发
- 改进Db类和查询类
- 精简一些不必要的类库
- 改进路由注册
- 由于异常的需要
View类改为内置，但默认仅支持原生PHP模板 - 大量细节改进和修正
V5.1.35
V5.2RC1
更新日志
- 改进Url类
build方法 - 修复获取当前页码数据类型
- 修正
parseKey方法传入数值的情况 - 改进
optimize:config指令对declare申明的支持 - 取消URL参数模式配置
- 增加
optimize:facade指令用于生成facade类的方法注释 - 取消
Query类的extend方法 - 原来的
Expression类更改为Raw类 - 增加新的
Expression类用于表达式查询扩展 Collection类增加whereLike/whereNotLike/whereIn/whereNotIn/whereBetween/whereNotBetween等快捷方法- Query类的
raw方法移动到Db类 - 取消
Request类的hook方法 - 修正
Route::view方法 - 优化模型获取器方法
- 多对多关联的
pivotDataName方法更名为name方法 - Query类增加
partition/duplicate/extra方法 - 改进mysql驱动支持分区和
duplicate以及额外参数 - mysql驱动的
insert方法改用更清晰的insert set语法 - 修正
Event类bind属性定义 - 修正验证类的
append一处bug - 改进
Query类update方法支持读取模型的更新条件 - 取消模型类的
getUpdateWhere方法统一使用getWhere方法 - 改进query类的
fetchArray方法处理 - 改进路由类取消
app属性 - 增加
think\facade\RuleName类 - 增加
whereFieldRaw查询方法 - 改进自动多应用名称获取
- App类增加
withEvent方法支持关闭事件机制 - 改进
Dispatch类对var_dump的支持 - 改进
hasMany的withCount自关联 - 修正纯数字检测参数类型转换问题
- 修正
raw助手函数 mysql支持find_in_set查询- 改进
url方法对自动多应用的支持
V5.1.34
V5.2Beta3
更新日志
路由
- 路由检测作为
AppInit事件响应独立出App类，可配置事件定义文件不使用路由功能 - 路由定义的方法简化
option和pattern参数，统一使用方法进行路由参数和变量规则设置 - 取消别名路由和快捷路由功能
- 取消多级控制器的自动搜索功能
- 路由分组不再支持数组方式定义分钟下面的路由规则
- 取消路由的
mergeExtraVars方法和设置 - 提升路由变量替换的性能
- 判断路由规则定义添加对请求类型的判断
- 路由地址支持
Dispatch对象
数据库和模型
- 改进模型的数据类型强制转换对
Expression对象的支持 - 模型查询统一返回对象 取消
findOrEmpty方法 模型类增加isEmpty方法 - 增加
raw助手函数 - 修正
mysql的regexp查询 - 改进聚合查询方法的
field参数支持Expression where方法支持传入Query对象- 改进
Connection类getRealSql方法 - Query类
cache方法支持传入CacheItem类 - Query类
find/select/cursor方法不再支持闭包 - 模型增加
lazySave方法 用于延迟自动保存 - 统一模型数据的读取和写入，支持驼峰和下划线自动智能识别
- 取消数据库的分表功能支持
- 改进
join方法支持参数绑定 - 取消
setInc/setDec方法和setField方法 - 模型增加
strict属性 支持开启字段区分大小写 默认不区分，数据库字段强制使用小写 - 取消查询方法的
eq neq lt gt elt egt等表达式 - 统一模型事件为使用模型事件观察者 废弃
event方法注册模型事件 - 增加
after_read模型事件 - 增加
whereYear/whereMonth/whereDay查询方法 - Query类
query方法支持查询缓存 - 增加
procedure方法用于指定是否为存储过程调用 - 简化
cursor、query和execute方法参数 - 废弃数据库执行次数 合并到查询次数
- Connection类
getCursor方法调整 取消relation参数 - 取消一对一关联的
setEagerlyType方法 - 改进软删除
destory方法重复执行事件的问题 - 修正多对多中间表的写入
- 改进关联模型的
save方法 - 增加乐观锁
Trait
控制器
- 取消
ActionBegin事件 - 改进控制器中间件执行
- 修正控制器名称获取
- 改进App类的
useClassSuffix方法的默认值 - 取消
controller_suffix配置，改用App类的controllerSuffix方法设置 - 取消
url_controller_layer配置，改用App类的controllerLayer方法设置 - 取消
class_suffix配置 - 取消
App类的action方法 - 取消
empty_controller配置，改用App类的emptyController方法设置 - 取消空操作
缓存
- 改进缓存
CacheItem类增加expire和tag方法支持 - 改进
CacheItem类getExpire方法 - 改进
CacheItem的缓存有效期处理 - 改进缓存类的
remember方法 - FIX：当使用
complex缓存的时候，通过store方法选择驱动，提供给connect的参数类型错误 - 改进Redis缓存驱动的
tag支持 - 改进
Redis驱动 - 改进缓存类 取消
xcache驱动 - 改进缓存标签的获取
- 增加缓存序列化的闭包支持
验证
- 改进
unique验证方法 - 改进验证类的自定义验证正则
- 验证方法调整
- 增加
validate助手函数
其它
- 改进
Cookie类的setCookie方法 App类增加classBaseName方法- 改进
Url生成的端口问题 - 修正
Request类param方法 - 语言检测、路由检查、请求缓存功能独立作为事件响应
Request增加单独的middleware方法传递中间件变量- 取消
App类的log方法 - 增加
exception_response_type配置参数