Laravel 7发行说明

2021-10-09 15:26:21 浏览数 (1)

版本化方案

Laravel及官方发布的包皆遵循 语义版本化。主要框架版本每六个月发布一次 (~2月和~8月),而次要和补丁版本可能每周发布一次。次要版本和补丁 决不 包含非兼容性更改。

引入 Laravel 框架或其组件时,应始终使用版本约束,如 ^7.0,因为 Laravel 的主要版本确实包含非兼容性更改。我们会努力确保您可以在一天或更短的时间内更新到最新版本。

支持政策

对于 LTS 版本,例如 Laravel 6,提供了 2 年的错误修复和3年的安全修复。这些版本提供了最长的支持和维护窗口。对于一般的发行版本,只提供了 6 个月的错误修复和 1 年的安全修复。对于包括 Lumen 在内的所有其他版本,只有最新版本才会修复错误。此外,请查阅 Laravel 支持的 数据库版本。

版本

发布时间

Bug 修复截止时间

安全修复截止时间

5.5 (LTS)

2017 年 8 月 30 日

2019 年 8 月 30 日

2020 年 8 月 30 日

5.6

2018 年 2 月 7 日

2018 年 8 月 7 日

2019 年 2 月 7 日

5.7

2018 年 9 月 4 日

2019 年 3 月 4 日

2019 年 9 月 4 日

5.8

2019 年 2 月 26 日

2019 年 8 月 26 日

2020 年 2 月 26 日

6 (LTS)

2019 年 9 月 3 日

2021 年 9 月 3 日

2022 年 9 月 3 日

7

2020 年 3 月 3 日

2020 年 9 月 3 日

2021 年 3 月 3 日

Laravel 7

Laravel 7 通过引入 Laravel Sanctum,路由速度改进,自定义 Eloquent 强制转换(casts), Blade 组件标签,流畅的字符串操作,开发人员专用的 HTTP 客户端, 第一方 CORS 支持, 路由模型绑定作用域改进, 存根自定义, 数据库队列改进, 多邮箱驱动, 查询时间强制转换(casts),新的 artisan test 命令,以及各种其他错误修复和可用性改进,对 Laravel 6.x 继续进行了改善。

Laravel Sanctum

Laravel Sanctum 由 Taylor Otwell建造。

Laravel Sanctum 为 SPA (单页应用程序),移动应用程序和基于令牌的简单 API 提供了轻巧的身份验证系统。 Sanctum 允许应用程序的每个用户生成多个 API 令牌。 这些令牌可以被授予能力/作用域,用于指定允许令牌执行哪些动作。

有关 Laravel Sanctum 的更多信息, 请查看 Sanctum 文档。

自定义 Eloquent 类型转换

自定义 Eloquent 类型转换由 Taylor Otwell 开发贡献.

Laravel 内置了多种常用的类型转换。但是,用户偶尔会需要将数据转换成自定义类型。现在,该需求可以通过定义一个实现 CastsAttributes 接口的类来完成

实现了该接口的类必须事先定义一个 get 和 set 方法。 get 方法负责将从数据库中获取的原始数据转换成对应的类型,而 set 方法则是将数据转换成对应的数据库类型以便存入数据库中。举个例子,下面我们将内置的 json 类型转换以自定义类型转换的形式重新实现一遍:

代码语言:javascript复制
<?php

namespace AppCasts;

use IlluminateContractsDatabaseEloquentCastsAttributes;

class Json implements CastsAttributes
{
    /**
     * 将取出的数据进行转换
     *
     * @param  IlluminateDatabaseEloquentModel  $model
     * @param  string  $key
     * @param  mixed  $value
     * @param  array  $attributes
     * @return array
     */
    public function get($model, $key, $value, $attributes)
    {
        return json_decode($value, true);
    }

    /**
     * 转换成将要进行存储的值
     *
     * @param  IlluminateDatabaseEloquentModel  $model
     * @param  string  $key
     * @param  array  $value
     * @param  array  $attributes
     * @return string
     */
    public function set($model, $key, $value, $attributes)
    {
        return json_encode($value);
    }
}

定义好自定义类型转换后,可以使用其类名称将其附加到模型属性:

代码语言:javascript复制
<?php

namespace App;

use AppCastsJson;
use IlluminateDatabaseEloquentModel;

class User extends Model
{
    /**
     * 这个属性应该被转化为原生类型
     *
     * @var array
     */
    protected $casts = [
        'options' => Json::class,
    ];
}

要学习如何实现自定义 Eloquent 类型转换,包括转换成特定值对象的类型转换,请参照 Eloquent documentation。

Blade 组件标签和变化

Blade 组件标签贡献人员有 SpatieMarcel PociotCaleb PorzioDries Vints, 和 Taylor Otwell.

{小提示} Blade 组件已经大刀阔斧修改,其中变化有允许基于标签的渲染,参数管理,组件类,内联视图组件众多变化。经过修改的 Blade 组件如此之多,请从这里 Blade文档来学习这些新特性。

总结为一句,现在的一个组件能从指定的类获取数据。所有的公开属性和方法都清晰地定义在组件类里,会自动组装成组件视图。任何附加的 HTML 属性都指定于一个可以被管理的自动包含$attribute 变量的组件,它是一个属性包的实例。

下面有个例子,我们会假设一个 AppViewComponentsAlert 组件定义是这样的:

代码语言:javascript复制
<?php

namespace AppViewComponents;

use IlluminateViewComponent;

class Alert extends Component
{
    /**
     * 提醒类型
     *
     * @var string
     */
    public $type;

    /**
     * 创建组件实例.
     *
     * @param  string  $type
     * @return void
     */
    public function __construct($type)
    {
        $this->type = $type;
    }

    /**
     *获取给提醒类型的类 
     *
     * @return string
     */
    public function classForType()
    {
        return $this->type == 'danger' ? 'alert-danger' : 'alert-warning';
    }

    /**
     * 获取渲染组件的视图/内容
     *
     * @return IlluminateViewView|string
     */
    public function render()
    {
        return view('components.alert');
    }
}

并且假设 Blade 组件模板定义是这样的:

代码语言:javascript复制
<!-- /resources/views/components/alert.blade.php -->

<div class="alert {{ $classForType() }}" {{ $attributes }}>
    {{ $heading }}

    {{ $slot }}
</div>

组件可以被渲染在另一个使用组件标签的 Blade 视图:

代码语言:javascript复制
<x-alert type="error" class="mb-4">
    <x-slot name="heading">
        Alert content...
    </x-slot>

    Default slot content...
</x-alert>

如前所述,在大改之后的 Laravel7 当中这是一个非常小又普通的一个功能,而且还没有演示匿名组件,内联视图组件和各种各样的其他特性。请从这里Blade文档来学习这些新特性

{注意} 以前的 Blade 组件 @component 语法没有被移除。

HTTP 客户端

HTTP 客户端是 Guzzle 的一个封装,由 Adam WathanJason McCreary,和 Taylor Otwell 提供。

Laravel 现在提供一套围绕 Guzzle HTTP 客户端](http://docs.guzzlephp.org/en/stable/) 构建的精简且高效的 API,允许你快速向其它 web 应用发起 HTTP 请求。Laravel 基于 Guzzle 的封装专注于最常见的用例和最棒的开发人员体验。例如,客户端发起带 JSON 数据的 POST 请求变得轻而易举:

代码语言:javascript复制
use IlluminateSupportFacadesHttp;

$response = Http::withHeaders([
    'X-First' => 'foo'
    'X-Second' => 'bar'
])->post('http://test.com/users', [
    'name' => 'Taylor',
]);

return $response['id'];

此外,HTTP 客户端还提供了令人惊叹且易于使用的测试功能:

代码语言:javascript复制
Http::fake([
    // Stub a JSON response for GitHub endpoints...
    'github.com/*' => Http::response(['foo' => 'bar'], 200, ['Headers']),

    // Stub a string response for Google endpoints...
    'google.com/*' => Http::response('Hello World', 200, ['Headers']),

    // Stub a series of responses for Facebook endpoints...
    'facebook.com/*' => Http::sequence()
                            ->push('Hello World', 200)
                            ->push(['foo' => 'bar'], 200)
                            ->pushStatus(404),
]);

了解更多 HTTP 客户端的特性,请查阅 HTTP 客户端文档.

流畅的字符串操作

流畅的字符串操作由 Taylor Otwell 开发贡献 。

你可能对 Laravel 已有的 IlluminateSupportStr 这个类比较熟悉,它提供了各种有用的字符串操作函数。基于这些函数, Laravel 7 现在提供了一个更加面向对象的、更加流畅的字符串操作库。你可以使用 Str::of 方法创建一个 IlluminateSupportStringable 对象。 然后可以使用该对象的各种方法去操作字符串:

代码语言:javascript复制
return (string) Str::of('  Laravel Framework 6.x ')
                    ->trim()
                    ->replace('6.x', '7.x')
                    ->slug();

有关流畅的字符串操作可用方法的更多信息, 请查阅完整文档。

路由模型绑定优化

路由模型绑定优化由 Taylor Otwell 开发贡献 。

自定义键名

有时你可能希望使用 id 以外的字段来解析 Eloquent 模型。 为此, Laravel 7 允许你在路由参数中指定某个字段:

代码语言:javascript复制
Route::get('api/posts/{post:slug}', function (AppPost $post) {
    return $post;
});

隐式绑定约束

有时,当在路由中隐式绑定多个 Eloquent 模型时,可能希望对第二个 Eloquent 模型进行约束,使其必须是第一个 Eloquent 模型的子类。例如,考虑这种情况,该情况是通过 Slug 为特定用户查找博客文章的:

代码语言:javascript复制
use AppPost;
use AppUser;

Route::get('api/users/{user}/posts/{post:slug}', function (User $user, Post $post) {
    return $post;
});

当使用自定义键隐式绑定作为嵌套的路由参数时,Laravel 7 将自动确定查询范围,以使用约定猜测其父级上的关系名称,以其父级检索嵌套模型。在这种情况下,将假定 User 模型关联了名为 posts(路由参数名称的复数) 的关系,该关系可用于检索 Post 模型。

有关路由模型绑定的更多信息,请查阅路由文档。

多邮件驱动程序

多邮件驱动程序支持由 Taylor Otwell 贡献。

Laravel 7 允许为单个应用配置多个邮件驱动。在 mail 配置文件中的每个邮件驱动都拥有它们自己的配置以及自己独特的 「transport」,这允许你的应用使用不同的邮件服务来发送某些邮件。例如,你的应用可以使用 Postmark 发送批量邮件,使用 Amazon SES 发送公务邮件。

默认情况下,Laravel 将使用 mail 配置文件中的 default 选项指定的邮件驱动作为邮件驱动。然而,你可以通过 mailer 方法来使用特定的邮件驱动来发送邮件。

代码语言:javascript复制
Mail::mailer('postmark')
        ->to($request->user())
        ->send(new OrderShipped($order));

路由缓存速度改进

路由缓存速度改进由上游的 Symfony 的贡献者和 Dries Vints 贡献

Laravel 7 提供了一种新的方法,用于匹配使用 Artisan 命令 route:cache 缓存的已编译缓存路由。在大型应用程序(例如,具有800条或更多路由的应用程序)上,这些改进可以使简单的「Hello World」基准测试每秒的请求速度 提高2倍 ,而无需更改应用程序。

CORS 支持

CORS 支持由 Barry vd. Heuvel 贡献

Laravel 7 通过集成由 Barry vd. Heuvel 编写的受欢迎的 Laravel CORS 软件包,为配置跨域资源共享(CORS) OPTIONS 请求响应提供了官方支持, 默认的 Laravel 应用程序框架 中包含一个新的 cors 配置。

有关 Laravel 7.x 中的 CORS 支持的更多信息,请查阅CORS文档。

查询时类型转换

查询时类型转换由 Matt Barlow 开发贡献.

有时候需要在查询执行过程中对特定属性进行类型转换,例如需要从数据库表中获取数据的时候。举个例子,请参考以下查询:

代码语言:javascript复制
use AppPost;
use AppUser;

$users = User::select([
    'users.*',
    'last_posted_at' => Post::selectRaw('MAX(created_at)')
            ->whereColumn('user_id', 'users.id')
])->get();

在该查询获取到的结果集中,last_posted_at 属性将会是一个字符串。假如我们在执行查询时进行 date 类型转换将更方便。你可以通过使用 withCasts 方法来完成上述操作:

代码语言:javascript复制
$users = User::select([
    'users.*',
    'last_posted_at' => Post::selectRaw('MAX(created_at)')
            ->whereColumn('user_id', 'users.id')
])->withCasts([
    'last_posted_at' => 'date'
])->get();

MySQL 8 数据库队列改进

MySQL 数据库队列改进由 Mohamed Said 开发贡献.

在先前版本的 Laravel 中, database 队列的健壮性被认为无法满足生产环境的需求。但是,Laravel 7 针对使用基于 MySQL 8 数据库队列的应用进行了改进。通过使用 FOR UPDATE SKIP LOCKED 语句进行 SQL 的优化,database 队列驱动可以安全地用于生产环境。

Artisan test 命令

test 命令由 Nuno Maduro 贡献

除了 phpunit命令之外,现在可以使用 test Artisan 命令来运行测试。 Artisan 测试运行器提供了漂亮的控制台,以及有关当前正在运行的测试的更多信息。 此外,运行器将在第一次测试失败时自动停止:

代码语言:javascript复制
php artisan test

可以传递给 phpunit 命令的任何参数也可以传递给 Artisan test 命令:

代码语言:javascript复制
php artisan test --group=feature

Markdown 邮件模板改进

Markdown 邮件模板改进由 Taylor Otwell 贡献

默认的Markdown邮件模板已基于Tailwind CSS调色板做出全新、更现代的设计。 当然,可以根据您的应用程序的需求来发布和定制此模板:

有关 Markdown 邮件的更多信息,请查看邮件发送.

自定义桩代码

自定义桩代码由 Taylor Otwell贡献

Artisan 控制台的 make 命令用于创建各种类,例如控制器,任务,迁移和测试。 这些类是根据输入填充值使用「桩代码」生成文件的。 但是,有时可能希望对 Artisan 生成的文件进行小的更改。 为此,Laravel 7提供了 stub:publish 命令来发布最常见的自定义桩代码:

代码语言:javascript复制
php artisan stub:publish

发布的桩代码将位于应用程序根目录中的 stubs 目录中。 当使用 Artisan 的 make 命令生成它们的相应类时,对这些桩代码所做的任何更改都会反映出来。

队列maxExceptions配置

maxExceptions属性由Mohamed Said提交贡献.

有时可能希望指定可以尝试多次的任务,但是如果重试是由给定数量的异常触发的,则该任务将失败。在Laravel7中,可以在任务类上定义 maxExceptions 属性:

代码语言:javascript复制
<?php

namespace AppJobs;

class ProcessPodcast implements ShouldQueue
{
    /**
     * 任务可以被重试的次数。
     *
     * @var int
     */
    public $tries = 25;

    /**
     * 失败之前允许抛出异常的最大次数。
     *
     * @var int
     */
    public $maxExceptions = 3;

    /**
     * 执行任务。
     *
     * @return void
     */
    public function handle()
    {
        Redis::throttle('key')->allow(10)->every(60)->then(function () {
            // 获取锁,处理博客进程...
        }, function () {
            // 无法获取锁...
            return $this->release(10);
        });
    }
}

在此示例中,如果应用程序无法获得 Redis 锁,则该任务将释放十秒钟,并将继续重试 25 次。但是,如果任务抛出三个未处理的异常,则该任务将失败。

0 人点赞