Laravel 5.5 需要 7.0+ 版本的 PHP。想要了解当前 PHP 版本所带来的功能,可以参考我们为你提供的回顾

Laravel 5.5 也将会是接下来的一个 LTS(长期支持)版本。 这就意味着它拥有两年修复以及三年的安全更新支持。Laravel 5.1 也是如此,不过它两年的错误修复支持将在今年结束。那么闲话少叙,让我们来看看这个新版本都提供了些什么吧。

创建一个新的 Laravel 5.5 项目

我们可以通过运行以下命令安装 dev 版本:

如果您不想使用 Laravel 安装程序,还可以使用 Composer

一旦我们访问了新设置的应用程序的主页,我们应该看到一个类似于我们以前的 Laravel 版本的欢迎页面。

在浏览器中渲染出邮件内容

我觉得这会是非常有用的东西。在 Laravel 之前的版本中,我们得实际去发送邮件,或者使用像 Mailtrap 这样的邮件客户端程序来测试邮件的布局,而这可不是啥好差事。时过境迁,有了 5.5 版本的 Laravel,局面得到改观,我们可以直接在浏览器调试邮件的布局显示。

达成此目的的捷径就是:给我们当前的工程创建一个新的可实际去发送的邮件模板:

我喜欢用 markdown 的方式来创建模板,里面会附上一些现成的内容。我们打开 web.php 文件,然后创建一个测试路由来查看 email 的布局:

        routes/web.php

通过浏览  /email 这个路由,我们就可以对 email 模板进行预览:

实际在幕后所发生的事情就是使用 Laravel 5.5, Mailable 类实现了拥有一个 render() 方法的 Renderable 协议。这个是 lluminate/Mail/Mailable.php 里面 render() 方法的实现:

lluminate/Mail/Mailable.php

这个就是让获取一个视图成为可能的那个方法。我们尝试过返回一个类的示例,它并没有实现在我们的路由之中的那个 Renderable 协议,这时候会得到的是一个 UnexpectedValueException 被抛出来。

自定义邮件主体

当邮件使用 Markdown 时,Laravel 会提供默认主题。 但是,有些人可能希望在电子邮件模板中使用自定义样式进行品牌推广。

要使用特定可用的自定义主题,我们首先创建一个包含我们想要的样式的自定义 .css 文件:

然后,我们将该文件名指定为 Mailable 类中的一个属性:

app/Mail/Welcome.php

这样,电子邮件布局将基于我们在 custom.css 文件中定义的样式。 这种方法的好处是不同的邮件使用不同的主题。

Exception 辅助函数

Laravel 5.5 带来了两个辅助函数,他们能帮助我们编写更富表达能力的代码。这两个辅助程序就是 throw_if 和 throw_unless 方法。两者都需要三个参数,而且第三个参数都是可选的。

让我们来看一下这些异常的各种不同的实现:

使用 throw_if 方法,异常会在第一个参数计算出来为 true 的时候被抛出。

实现 throw_unless 方法跟我们上面所做的并没有不同, 唯一的差别就是异常只会在第一个参数计算出来为 false 的时候被抛出:

例子并不是最好的,但足够来体现我们的展示意图了。

介绍 migrate:fresh 命令

你可能发现自己处于需要重建数据库的境地。在以前的 Laravel 版本中,我们通过运行 php artisan migrate:refresh 命令来实现。migrate:refresh 命令基于针对每个迁移文件的 down 方法指定的内容回滚所有迁移,然后再次运行迁移:

但你可能数次遇到这个命令的问题,尤其是使用外键约束或者你的某个迁移中存在定义得不太好的 down() 方法。如果发生这样的事情,我们多数时候会手工删除产生问题的表 —— (可能通过 CLI 或 GUI)。这正是 migrate:fresh 能帮助我们的地方。这个命令删除所有表,然后再次运行已经存在的迁移:

JSON 型错误堆栈跟踪

虽然不是一个很大的变化,但是在之前的 Laravel 版本中,每次我们在构建 API 出错时,我们在一个 API 客户端(如 Postman)看到的是 HTML 标记。 在 Laravel 5.5 中,如果发生错误,我们会得到一个 JSON 型堆栈跟踪,而不是 HTML 标记,这看起来更加简单易用:

自动包发现

这些是我们遵循的步骤,以便在我们的 Laravel 项目中使用第三方软件包。

  • 安装包
  • 注册包服务的提供商
  • 如果有任何 facade 的话就注册

步骤看起来很简单。

通过自动软件包可以发现,我们只需要一个软件包即可开始使用包。 但是请注意,只有在软件包提供程序配置了自动发现的软件包时,才能生效。

看看 Laravel Debugbar 包,它已经更新了 autodiscovery,我们来看看 composer.json 文件的 extra 段:

包的供应者会更新有 extra 段的 composer.json 文件,然后指定供应者和包的别名。

第三方组件的自动检测功能(Automatic Package Discovery)的另一个好处是移除了某个依赖项之后不会造成破坏。一般来说,就算我们卸载了某个包,还有包服务的供应者,以及围绕在 config/app.php 文件周围的假象,这在某些情况会导致问题的发生。

有了包自动发现,如果某个包被 Composer 删除掉了,与这个包相关的东西都会被删除。

vendor 的改动:publish 命令

在之前的 Laravel 版本中,运行 vendor:publish 命令将发布包中所有的资源,并从框架本身中发布一些资源。发布的一些资源包括迁移、视图和配置。

使用 Laravel 5.5 之后,我们必须对运行此命令时要发布的内容有一些更明确的说明。如果我们运行在 php artisan vendor:publis 命令并不传递任何标志,我们将被提示选择提供商 vendor 或标签,以使其更容易仅发布我们想要的资源。见下面的截图:

我们可以通过在执行 publish 命令时指定 --all 或 --provider 标志来绕过该提示:

前端预设的多样化

在 Laravel 5.3 和 5.4 中,我们默认有一些对 Vue 和 Bootstrap 辅助配置来帮助我们使用前端。在这个新版本中,React 已经被包含在这个组合中。但默认情况下 React 是不支持的。

其中有一个新的 artisan 命令来管理前端预设。这意味着我们只能使用我们想要使用的预设的辅助配置。但是并不是每个人都希望使用默认的前端预设 - 例如 Vue,Bootstrap 和 React - 并且可能在其他的前端上使用新的选项,也许是一个不同的前端框架。Laravel 已经考虑到了这一点了:

上述命令将删除任何现有的前端辅助配置。如果我们想使用 React 作为我们的前端,下面的命令会让我们得到一些 React 辅助配置:

下面是这些新命令执行时候的截屏:

Whoops 归来

Laravel 5.5 中 Whoops 回归,更改了错误显示的方式。有了 Whoops !,每次在开发中出现错误时,我们都可以看到如截图所示的导致错误出现的代码行以及错误消息。

在我看来,新的处理器上错误消息的显示更加好看,对导致错误出现的代码行进行截屏使调试更容易:

Whoops 错误示例:

另一件很酷的事情是,Whoops 可以直接在 IDE 或编辑器中打开引用的文件。此功能仅适用于在本地可以通过安装编辑器进行计算机访问的 PHP 源文件。要实现这一点,请转到 app / Exceptions / Handler.php 并添加此代码段:

appExceptionsHandler.php

上面的代码片段通过添加以下行:$ handler-> setEditor('sublime')来覆盖基类中的whoopsHandler() 方法,这将导致链接在 Sublime Text 中打开。如果您使用其他编辑器,请访问此链接以查看支持的编辑器列表,以及如何添加自己的编辑器。 Mac 用户不要忘记下载 sublime 的 URL 协议,以使其工作。

自定义报告异常的方法

在以的版本的 Laravel 中,如果我们想以特定的方式自定义异常处理,我们必须把逻辑放在 Handler.php 文件的 report 方法中。下面是例子:

        app/Exceptions/Handler.php

假设我们有 50 个左右的自定义异常 —— 悲剧了。

而在 Laravel 5.5 中,如果想指定在异常抛出时做点什么,可以在异常内创建 report() 方法:

app/Exceptions/CustomException.php

模型工厂生成器

Laravel 5.5 带来了新的命令用于创建模型工厂。在我们写测试的时候,如果想生成一些假数据或某个对象的新实例,模型工厂就派上用场了。

为特定的类生成工作,需要运行这个命令:

如果我们浏览 database/factories,就会看到 PostFactory 类:

database/factories/PostFactory.php

我发现由于关系分离,这种方式显得更简洁。在以前版本的 Laravel 中,所有工厂都在 app/factries/ModelFactory.php 文件中。

返回验证数据

现在可以从验证器得到数据,并将这个数据传递给 create 方法。以前版本的 Laravel 中我们这样创建对象:

Laravel 5.5 现在让我们直接从验证过的数据创建对象:

Laravel 5.5 中也可以直接在请求实例上调用 validate:

不过现在我们需要谨慎使用该方法来创建对象,因为验证方法未处理的属性都会没有值。为了克服这个问题,我们会向验证方法传入需要创建对象的所有属性,哪怕这些值不需要验证:

这样,数据会自动添加到允许请求的数据中,但不会接受任何验证规则的约束。

自定义验证规则

在以前版本的 Laravel 中可以使用 Validator::extend 方法来自定义验证规则。不过东西比较分散。我们有规则在 AppServiceProvider 文件中,而消息在 resources/lang/en/validation.php 文件中。看 Laravel 文档了解 Laravel 5.4 中如何实现。

Laravel 5.5 中我们有新的 artisan 命令来自定义验证规则。这个命令可生成一个实现了 Rule 约定的类。现在我们生成一个新的规则来看看生成的文件中都有什么:

在 app/Rules/CustomRule.php 中我们看到两个方法,passes 方法和 message 方法。passes 方法有两个参数,attribute 和 value,其返回值是布尔类型。不要疑惑,$attribute 是用于验证的域,而 $value 是那个属性的值。

下面的示例中,假设我们不希望应用中使用某个名字,那么 我们的 Rule 看起来像这样:

app/Rules/CustomRule.php

然后使用新规则来验证我们的 username 属性:

app/Rules/CustomRule.php

看看 Taylor Otwell 发表的文章,它深入研究了如何在新版本的 Laravel 中自定义验证。

集合中的 DD 和 Dump 支持

集合现在拥有一个 dump() 方法以及一个 dd() 方法。在以前的 Laravel 版本中,当调试集合时,我们会为一个集合分配一个变量,然后在更改集合时继续转储变量。在 Laravel 5.5 中不再是这样的了,因为我们现在可以直接在集合上调用 dd() 或 dump() 接口,从而使得调试更容易。

假定我们有一个 posts 的集合,其中通过一系列变换得到,我们希望在逐步检查集合中的数据,那么可以这样做:

同时输出如下:

这样可以很方便地在逐步检查集合的内容。但是请注意,在集合上调用 dump() 和调用 dd() 是有区别的。dump() 输出结果,然后继续处理;但 dd() 则会立即停止进程并转储结果(dd 代表 dump & die)。曾经我们每一步都在集合上调用 dd(),我们只会在得到我们首次在集合上调用 dd() 的结果。考虑下这个:

输出结果是不同的:

Pivot 表中多对多关系的类型转换

通常,可以在 Model 上声明一个 casts 属性,该属性定义了如何保存或读取指定属性。假设我们有一个 Post Model,在它的值域中,我们希望在读取和写入时将其中一个字段序列化为 JSON 格式,那么下面的代码片段将帮助我们实现该功能:

他们甚至实现了在 Laravel 5.4 中建立多对多关系的用户自定义 pivot 转换,但这仅限于读取数据。如果我们要对数据执行写操作,我们在最终保存数据前必须先手动转换其属性值。因为 EloquentModel 和 EloquentRelationshipPivot 类的 $casts 属性将通过同样的行为使 attach、sync、save 方法在 pivot model 中可用,但情况可能就不一样了。

自定义 Blade::if() 指令

Blade 模板中冗长重复的检查使得模板看起来很丑陋。好在现在可以从模板中抽出这些重复检查,这就能使我们的模板看起来更整洁、更易读。检查语句如下:

可被替换为

创建自定义 blade 指令的逻辑主要位于 AppServiceProvider 类的 boot 方法中:

app/Providers/AppServiceProvider.php

一些检查语句可能需要将参数传递给某种方法。在这种情况下,当我们遇到一个自定义 blade 指令时,我们会将一个参数传递给闭包。

使用上述条件作为示例,我们看到我们需要 $user->id 传递到 isFollowing() 方法中。要创建一个自定义 blade 指令,它将 $user-> id 作为参数:

之后就可以在我们的模板中使用新的指令了:

在内核中自动注册新的 Artisan 命令

我们通常运行命令 php artisam make:command command-name 来创建新的 artisan 命令。这之后,我们使用该命令声明我们在类中的签名,然后转到内核并手动注册该命令。

在内核中注册新的命令将不再是必需的了。在 app/Console/kernel.php 文件中,我们有一个新的方法,支持在命令目录中超查找,并将所有文件路径转换为命名空间的路径:

假设我们引用了一个尚未在内核中注册的命令,那么 commands() 方法将自动解析该命令。

新的路由方法

这并不是一个很大的功能,但是我们现在有两种额外的路由方法:

第一条路由将 welcom 视图映射到 /welcome 路由上,而第二条路由将重定向所有发给 /home 的请求到 /dashboard 上。

引入 Laravel Horizon

这是一个全新的 Laravel 包,它为 Laravel Redis 队列提供了一个面板以及代码驱动的配置系统:

Horizon 提供对队列工作负载、近期作业、失败作业、作业重试、吞吐量和运行时指标以及进程计数的实时分析。
Horizon 的一些功能包括:

  • 作业的高层分析 - 类似每分钟的作业数目,过去一小时的作业状况等
  • 作业和专门针对排队的分析
  • 标签和监控 - 支持向作业添加标签,并监视某些标签
  • 近期作业 - 我们可以获得有关近期作业的信息
  • 队列均衡策略 - Horizon 可以根据这些队列的工作负载情况自动均衡队列中的工作进程

参见 Taylor Otwell 的文章,其中深入分析了如何配置 Horizon 及 Horizon 所包含的所有功能。我们还将推出一篇专门介绍的 Horizon 撰文,敬请关注。

新的数据库迁移 trait

这就是 RefreshDatabase trait。有些人可能会怀疑我们是否真的需要这个,但这样做是有道理的。最初我们拥有 DatabaseMigrations 和 DatabaseTransactions 两个 trait。

在我们的测试中使用 DatabaseMigrations trait 可确保在每次测试之前和之后运行的迁移正确,而 DatabaseTransactions trait 确保在运行每个测试后数据库恢复到初始状态。

RefreshDatabase trait 将通过在测试开始时迁移数据库一次,然后在之后运行每个测试时使用事务,从而实现这两种功能。这样做的好处是我们不必为每个测试重新迁移数据库,这意味着更快的测试。

结论

你可以看到,我们有很多令人兴奋的新东西。 更多的功能还在推出,所以请关注这篇文章,我们将保持更新。 在下面的评论部分留下您的想法和建议,不要忘记与 Laravel 爱好者分享这篇文章!

5 收藏


直接登录

推荐关注