MyGit

v6.0.0-rc3

top-think/framework

版本发布时间: 2019-06-03 06:49:49

top-think/framework最新发布版本:v8.0.4(2024-07-30 09:55:55)

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类buildUrlurl助手函数返回类型改为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字段数据,但会包含field2field3的数据。

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();

模型数据集增加deleteupdate方法

可以批量对数据集进行更新和删除操作(支持模型事件)

// 更新今天的数据
$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';
}

模型提供了动态切换方法switchsetSuffix,例如:

// 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配置参数

可以配置禁止直接访问的应用列表

控制器中间件改进

控制器中间件的onlyexcept定义不区分大小写

app_map支持指定泛应用映射

可以在app_map配置中定义泛应用解析到指定应用,例如:

'app_map' => [
    'think'  =>  'admin',  // 把admin应用映射为think
   // ... 其它应用映射定义
    '*' => 'home', // 其它应用解析到home
],

问题修正

用法调整

废弃用法

相关地址:原始地址 下载(tar) 下载(zip)

查看:2019-06-03发行的版本