发行说明

未匹配的标注
本文档最新版为 10.x,旧版本可能放弃维护,推荐阅读最新版!

Laravel 发行说明#

支持策略#

对于 LTS 版本,比如 Laravel 5.1,会提供为期两年的 bug 修复和三年的安全修复支持。LTS 版本是 Laravel 能提供的维护时间最长的发行版。

对于其他通用版本,只提供六个月的 bug 修复和一年的安全修复支持。

Laravel 的发布路线图 - by Summer

Laravel 5.4.22#

Laravel 5.4.22 为 Laravel 5.4 系列版本中能对应用程序中的用户进行网络钓鱼的安全漏洞安装了补丁。使用密码重置系统,恶意用户可以尝试欺骗你的用户将登录凭据输入到他们控制的单独应用程序中。由于密码重置通知使用主机传入请求来获取重置密码的 URL,因此用来生成重置密码的 URL 的主机可能会被欺骗。如果用户没有注意到他们访问的域名不正确,他们可能会意外将自己的登录凭据输入到恶意的应用程序中。

在 Laravel 5.1 的应用程序中,密码重置通知由开发人员维护,因此此漏洞可能存在或可能不存在。你应该验证应用程序生成密码重置的链接是否是绝对的 URL:

{{ url('http://example.com/password/reset/'.$token) }}

Laravel 5.4#

Laravel 5.4 继续在 Laravel 5.3 的基础上进行优化,新特性包括以下:

  • 在邮件和通知中支持 Markdown
  • Laravel Dusk 浏览器自动测试框架
  • Laravel Mix;
  • Blade "components" 和 "slots";
  • 在广播频道上进行路由模型绑定;
  • 在集合中支持高阶消息传递;
  • 基于对象的 Eloquent 事件;
  • 任务级别的「重试」和「超时」设置;
  • "实时" Facades;
  • 更好的支持 Redis Cluster;
  • 自定义 pivot 表模型;
  • 两个新的中间件,用于输入修剪空格和清除非必要字段,等等。

此外,还对整个框架代码进行了 reviewed 和重构,以使代码更加干净和清晰。

{tip} 这个文档总结了许多框架值得注意的改进。需要知道更多细节请参考 Github 上的更新记录 on GitHub

Markdown 邮件和通知#

{video} Laracasts 上关于此新特性的免费视频 video tutorial

此新特性允许我们在邮件通知中使用 Markdown 语法,Laravel 可以将这些消息渲染成美观、响应式的 HTML 模板,同时自动生成纯文本副本,下面是一个 Markdown 格式的邮件示例:

@component('mail::message')
# Order Shipped

Your order has been shipped!

@component('mail::button', ['url' => $url])
View Order
@endcomponent

Next Steps:

- Track Your Order On Our Website
- Pre-Sign For Delivery

Thanks,<br>
{{ config('app.name') }}
@endcomponent

利用这个简单的 Markdown 模板,Laravel 可以生成一个响应式 HTML 邮件和纯文本副本:

markdown.png

要想了解更多细节,查看 mailnotification 文档。

{tip} 你可以导出所有的 Markdown 邮件组件到自己的应用中进行自定义。使用 vendor:publish Artisan 命令 laravel-mail 选项来导出资源。

Laravel Dusk#

{video} Laracasts 上关于此新特性的免费视频 video tutorial

Laravel Dusk 提供一个优雅,简单易用的浏览器自动化测试 API。默认情况下,Dusk 不需要再你安装 JDK 或 Selenium 。Dusk 使用独立的 ChromeDriver 安装方式。你也可自由的使用其他 Selenium 兼容驱动。

Dusk 运行使用真实的浏览器,所有你可以轻松地对那些重度使用 JavaScript 的引用进行测试和交互:

/**
 * 一个基本浏览器测试例子.
 *
 * @return void
 */
public function testBasicExample()
{
    $user = factory(User::class)->create([
        'email' => 'taylor@laravel.com',
    ]);

    $this->browse(function ($browser) use ($user) {
        $browser->loginAs($user)
                ->visit('/home')
                ->press('Create Playlist')
                ->whenAvailable('.playlist-modal', function ($modal) {
                    $modal->type('name', 'My Playlist')
                          ->press('Create');
                });

        $browser->waitForText('Playlist Created');
    });
}

需要了解更多关于 Dusk 的细节,查看 Dusk 文档

Laravel Mix#

{video} Laracasts 上关于此新特性的免费视频 video tutorial

Laravel Mix 是 Laravel Elixir 思想继承者,完全基于 Webpack 而非 Gulp。Laravel Mix 提供流式 API 定义 Webpack 构建步骤,有几种已经定义的 CSS 和 JavaScript 预处理器。通过简单的方法链,你可以流畅的定义你的资源构建流水线。例如:

mix.js('resources/assets/js/app.js', 'public/js')
   .sass('resources/assets/sass/app.scss', 'public/css');

Blade Components & Slots#

{video} Laracasts 上关于此新特性的免费视频 video tutorial

Blade components 和 slots 提供与 sections 和 layouts 相似的功能;然而,有些人会觉得 components 和 slots 的思想更易理解。首先,让我们假设一个可重用的 "alert" 组件想要在整个应用进行重用:

<!-- /resources/views/alert.blade.php -->

<div class="alert alert-danger">
    {{ $slot }}
</div>

{{ $slot }} 变量包含我们想要插入的组件内容,要构建这个组件,我们可以使用 component Blade 指令:

@component('alert')
    <strong>Whoops!</strong> Something went wrong!
@endcomponent

命名 slots 允许在单个组件中定义多个 slots:

<!-- /resources/views/alert.blade.php -->

<div class="alert alert-danger">
    <div class="alert-title">{{ $title }}</div>

    {{ $slot }}
</div>

命名 slots 可以通过 @slot 指令注入。一个 @slot 中的所有内容都会被传递给 @slot 变量:

@component('alert')
    @slot('title')
        Forbidden
    @endslot

    You are not allowed to access this resource!
@endcomponent

需要了解更多关于 components 和 slots 的细节,查看 Blade documentation

广播模型绑定#

和 HTTP 路由一样,频道路由也使用隐式和显式 路由模型绑定。例如,可以通过请求一个实际的 Order 模型实例来取代之前获取字符串或数字订单 ID ID:

use App\Order;

Broadcast::channel('order.{order}', function ($user, Order $order) {
    return $user->id === $order->user_id;
});

需要了解更多关于广播模型绑定,查看 事件广播

集合高阶消息传递#

{video} Laracasts 上关于此新特性的免费视频 video tutorial

集合现在支持 "高阶消息传递",从而使集合的操作更为精简,目前支持高阶消息传递方法有:

containseacheveryfilterfirstmappartitionrejectsortBysortByDescsum

每一个高阶消息传递都可以通过集合实例的动态属性进行访问,例如,使用 each 的高阶消息传递去调用集合的某个对象:

$users = User::where('votes', '>', 500)->get();

$users->each->markAsVip();

类似的,我们可以通过 sum 的高阶消息传递在用户集合中聚合所有的投票数:

$users = User::where('group', 'Development')->get();

return $users->sum->votes;

基于对象的 Eloquent 事件#

{video} Laracasts 上关于此新特性的免费视频 video tutorial

Eloquent 事件处理器现在可以被映射到事件对象上。这提供了一种直观处理 Eloquent 事件并易于测试的方式。在开始使用之前,先在你的 Eloquent 模型中定义一个 $events 属性数组,在这个数组中可以定义 Eloquent 模型的生命周期中属于你的 事件 classes:

<?php

namespace App;

use App\Events\UserSaved;
use App\Events\UserDeleted;
use Illuminate\Notifications\Notifiable;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
    use Notifiable;

    /**
     * The event map for the model.
     *
     * @var array
     */
    protected $events = [
        'saved' => UserSaved::class,
        'deleted' => UserDeleted::class,
    ];
}

任务级别重试和超时#

5.4 版本以前,任务队列 "retry" 和 "timeout" 设置只能在全局的队列配置中用命令行设置。现在可以单独在任务类中配置每一个任务的 "重试" 和 "超时":

<?php

namespace App\Jobs;

class ProcessPodcast implements ShouldQueue
{
    /**
     * The number of times the job may be attempted.
     *
     * @var int
     */
    public $tries = 5;

    /**
     * The number of seconds the job can run before timing out.
     *
     * @var int
     */
    public $timeout = 120;
}

需要了更多,查看 队列.

请求清理中间件#

{video} Laracasts 上关于此新特性的免费视频 video tutorial

Laravel 5.4 在默认的中间件栈中引入了两个新的中间件:TrimStringsConvertEmptyStringsToNull

/**
 * 应用的全局 HTTP 中间件栈
 *
 * 这些中间件会对你的每一个请求运行
 *
 * @var array
 */
protected $middleware = [
    \Illuminate\Foundation\Http\Middleware\CheckForMaintenanceMode::class,
    \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
    \App\Http\Middleware\TrimStrings::class,
    \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
];

新增的中间件会自动去除请求输入值首尾的空格、将空字符串转换为 null。这可以帮助你获得正确的输入而不需要重复在每一个路由和控制器中调用 trim 方法。

"实时" Facades#

{video} Laracasts 上关于此新特性的免费视频 video tutorial

5.4 版本以前,只有 Laravel 内置的服务才可以提供 Facades,提供快速的,简短的方式访问这些服务容器的方法。在 Laravel 5.4 中,你可以轻松的将你的任意类库实时的转换成 Facades,只需要将类名导入到 Facades 中。例如,假设你的应用中有这样一个类:

<?php

namespace App\Services;

class PaymentGateway
{
    protected $tax;

    /**
     * 创建一个新的支付网关实例
     *
     * @param  TaxCalculator  $tax
     * @return void
     */
    public function __construct(TaxCalculator $tax)
    {
        $this->tax = $tax;
    }

    /**
     * Pay the given amount.
     *
     * @param  int  $amount
     * @return void
     */
    public function pay($amount)
    {
        // Pay an amount...
    }
}

你可以这样以 Facades 的方式调用这个类的方法:

use Facades\ {
    App\Services\PaymentGateway
};

Route::get('/pay/{amount}', function ($amount) {
    PaymentGateway::pay($amount);
});

当然,如果你以这种方式实现实时 Facades ,就可以使用 Laravel 的 Facades 模拟功能 编写测试用例:

PaymentGateway::shouldReceive('pay')->with('100');

自定义 Pivot 表模型#

在 Laravel 5.3, 所有的 belongsToMany 关联关系使用同一个内置的 Pivot 模型实例。在 Laravel 5.4 中你可以为这些 pivot 表自定义模型类,如果你想要定义一个自定义模型,可以在定义关联关系时使用 using 方法:

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Role extends Model
{
    /**
     * 属于这个角色的用户
     */
    public function users()
    {
        return $this->belongsToMany('App\User')->using('App\UserRole');
    }
}

优化 Redis 集群支持#

5.4 版本以前,在同一个应用中不能同时定义 Redis 链接指向单个主机和集群,在 Laravel 5.4 中可以在同一个应用中定义 Redis 链接指向多个主机和多个集群。

更多关于 Laravel 中 Redis 的信息,查看 Redis 文档

迁移默认字符长度#

Laravel 5.4 默认使用 utf8mb4 字符编码,该编码支持对 "emojis" 表情在数据库进行存储。如果你从 Laravel 5.3 升级,不需要对字符编码做切换。

如果你选择手动切换到这个字符编码,并且运行小于 MySQL 5.7.7 release 版本的数据库,你可能还需要手动配置迁移命令生成默认字符长度,你可以在 AppServiceProvider 中调用 Schema::defaultStringLength 方法来实现这一配置:

use Illuminate\Support\Facades\Schema;

/**
 * 引导任何应用服务
 *
 * @return void
 */
public function boot()
{
    Schema::defaultStringLength(191);
}

Laravel 5.3#

Laravel 5.3 在 5.2 基础上进行了优化,新特性包括以下:

消息通知#

{video} Laracasts 上关于此新特性的免费视频 video tutorial

Laravel Notifications 提供了简单、优雅的 API 支持你通过不同的渠道发送通知,例如电子邮件、Slack、手机短信等等。

例如,你可以定义一个单据,当该单据被付款后,则通过邮件和手机短信发送提醒通知:

你可用通过下面这个简单的方法来实现:

$user->notify(new InvoicePaid($invoice));

Laravel 社区 已经为通知系统编写了各式的驱动,甚至包括对 iOS 和 Android 通知的支持,更多关于通知系统的信息,请查看 完整的文档

WebSockets / 事件广播#

事件广播在之前版本的 Laravel 中已经存在,Laravel 5.3 现支持对私有和已存在的 WebSocket 频道添加频道级认证:

/*
 * 频道认证
 */
Broadcast::channel('orders.*', function ($user, $orderId) {
    return $user->placedOrder($orderId);
});

Laravel Echo 是一个可通过 NPM 安装的全新的 JavaScript 包,会随 Laravel 5.3 一起发布。Echo 提供了简单、优雅的 API 接口,支持你在 JavaScript 客户端应用中,订阅频道和监听服务器端事件。

Echo 提供的支持包括 Pusher 以及 Socket.io

Echo.channel('orders.' + orderId)
    .listen('ShippingStatusUpdated', (e) => {
        console.log(e.description);
    });

除了订阅到传统频道上,Laravel Echo 也让频道的监听与管理变得更加简单:

Echo.join('chat.' + roomId)
    .here((users) => {
        //
    })
    .joining((user) => {
        console.log(user.name);
    })
    .leaving((user) => {
        console.log(user.name);
    });

了解更多关于 Echo 和事件广播的信息,请查阅 完整文档.

Laravel Passport (OAuth2 认证服务)#

{video} Laracasts 上关于此功能的免费视频 video tutorial

Laravel 5.3 的 Passport 让 API 认证变得简单。Laravel Passport 可以让你在几分钟内为应用程序创建一个完整的 OAuth2 认证服务,Passport 基于 Alex Bilbie 的 League OAuth2 server 实现。

Passport 让发放 OAuth2 令牌(Access Token)变得轻松,你还可以允许用户通过 Web 界面创建 个人访问令牌

为了方便提高开发效率,Passport 内置了一个 Vue 组件,该组件提供了 OAuth2 后台界面功能,允许用户创建客户端、撤销访问令牌,以及更多其他功能:

<passport-clients></passport-clients>
<passport-authorized-clients></passport-authorized-clients>
<passport-personal-access-tokens></passport-personal-access-tokens>

如果你不想使用 Vue 组件,你可以自由的定制用于管理客户端和访问令牌的前端及后台。Passport 提供了一个简单的 JSON API,你可以在前端使用任何 JavaScript 框架与之集成。

Passport 还提供了方便的 API 让你定制「Token 访问域」:

Passport::tokensCan([
    'place-orders' => 'Place new orders',
    'check-status' => 'Check order status',
]);

此外,Passport 还包含了一个用于检查「Token 访问域」访问权限的中间件:

Route::get('/orders/{order}/status', function (Order $order) {
    // 检查令牌是否拥有 "check-status" 访问域
})->middleware('scope:check-status');

最后,Passport 还支持从 JavaScript 应用访问你的 API,而不必担心访问令牌传输。

Passport 通过加密 JWT cookies 和同步「CSRF 令牌」来实现此功能,让你专注于业务开发。

更多关于 Passport 信息,请查看 完整文档

搜索系统 Laravel Scout#

Laravel Scout 提供了一个简单的、基于驱动的、针对 Eloquent 模型的全文搜索解决方案。

通过模型观察者,Scout 会自动同步更新 Eloquent 的搜索索引,目前,Scout 使用 Algolia 驱动,你可以自由的编写自己驱动来扩展 Scout。

你只需要添加 Searchable trait 到模型中,就能让模型支持搜索:

<?php

namespace App;

use Laravel\Scout\Searchable;
use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    use Searchable;
}

在你在模型中添加 trait 以后,数据会在 save 的时候自动保持同步:

$order = new Order;

// ...

$order->save();

在模型被成功索引以后,可以很轻松的使用全文搜索,你甚至可以为索引的结果进行分页操作:

return Order::search('Star Trek')->get();

return Order::search('Star Trek')->where('user_id', 1)->paginate();

更多 Scout 功能,请查阅 Scout 的完整文档

Mailable 对象#

{video} Laracasts 上关于此功能的免费视频 video tutorial

Laravel 5.3 Mailable 是一个崭新的 Mail 操作类,通过一种更加优雅的方式发送邮件,而不再需要在闭包中自定义邮件信息。

例如,定义一个简单的邮寄对象用作发送欢迎邮件:

class WelcomeMessage extends Mailable
{
    use Queueable, SerializesModels;

    /**
     * 新建消息
     *
     * @return $this
     */
    public function build()
    {
        return $this->view('emails.welcome');
    }
}

Mailable 对象被创建以后,你可以使用一个简单、优雅的 API 将其发送给用户:

Mail::to($user)->send(new WelcomeMessage);

Mailable 还支持队列操作,只需要在类声明里实现 ShouldQueue 即可:

class WelcomeMessage extends Mailable implements ShouldQueue
{
    //
}

更多关于 Mailable 的信息,请查看 完整文档

存储上传文件#

{video} Laracasts 上关于此功能的免费视频 video tutorial

存储用户上传文件,在 Web 开发中是一个很常见的任务。

Laravel 5.3 提供了一个便捷的 store 方法,只需要对上传文件对象调用此方法,并传参准备存储的路径即可:

/**
 * 更新用户头像
 *
 * @param  Request  $request
 * @return Response
 */
public function update(Request $request)
{
    $path = $request->file('avatar')->store('avatars', 's3');

    return $path;
}

更多上传文件信息,请查看 完整文档

Webpack 和 Laravel Elixir#

Laravel Elixir 6.0 与 Laravel 5.3 共同发布,内置了 Webpack 和 Rollup JavaScript。

默认情况下,Laravel 5.3 的 gulpfile.js 使用 Webpack 来编译你的 JavaScript 文件:

elixir(mix => {
    mix.sass('app.scss')
       .webpack('app.js');
});

完整文档请见 Laravel Elixir

前端架构#

{video} Laracasts 上关于此功能的免费视频 video tutorial

Laravel 5.3 提供了一个更加现代的前端架构。这主要会影响 make:auth 命令生成认证相关的前端脚手架代码,不再从 CDN 中加载前端资源,所有依赖被定义在默认的 package.json 文件中,你可以自行修改。

此外,支持单文件的 Vue 组件 现在直接开箱即用, resources/assets/js/components 目录下包含了一个简单的示例 Example.vue,新的 resources/assets/js/app.js 用来配置 JavaScript 类库依赖和 Vue 子模块。

这种架构对开始开发现代的、强大的 JavaScript 应用提供了更好的支持,而不需要要求应用使用任何特定 JavaScript 或者 CSS 框架。

更多信息,请查看对应文档 前端文档

路由文件#

默认情况下,新安装的 Laravel 5.3 应用在新的顶级目录 routes 下包含了 web.phpapi.php 两个 HTTP 路由文件,你也可以按照此方法自行扩展。

API 相关的路由在 RouteServiceProvider 中指定了自动添加 api 前缀。

闭包控制台命令#

除了通过命令类定义之外,Artisan 命令现支持在 app/Console/Kernel.php 文件中使用简单闭包的方式定义。

在新安装的 Laravel 5.3 应用中,commands 方法会加载 routes/console.php 文件,从而允许你基于闭包、以路由风格定义控制台命令:

Artisan::command('build {project}', function ($project) {
    $this->info('Building project...');
});

更多信息请参见 Artisan 文档

Blade 中的 $loop 魔术变量#

{video} Laracasts 上关于此功能的免费视频 video tutorial

当我们在 Blade 模板中循环遍历的时候,$loop 魔术变量将会在循环中生效。通过该变量可以访问很多有用的信息,比如当前循环索引值,以及当前循环是第一个还是最后一个:

@foreach ($users as $user)
    @if ($loop->first)
        This is the first iteration.
    @endif

    @if ($loop->last)
        This is the last iteration.
    @endif

    <p>This is user {{ $user->id }}</p>
@endforeach

更多信息请查看 Blade 文档.

Laravel 5.2#

Laravel 5.2 在 Laravel 5.1 的基础上进行了优化,新特性包括以下:

  • 支持更多样的用户认证驱动;
  • 隐式数据模型绑定;
  • 简化 Eloquent 全局作用域;
  • 内置用户认证脚手架支持;
  • 中间件组;
  • 访问频率限制中间件;
  • 数组认证的优化等

用户认证驱动 / "多认证系统"#

在之前的 Laravel 版本中,框架只支持默认的、基于 session 的认证驱动,且在单个应用中只能拥有一个认证模型类。

Laravel 5.2 对此进行了改进,你可以定义多个认证驱动,还支持多个可认证的数据模型以及用户表,并且可以独立控制其认证。

例如,如果你的应用中有一张「admin」数据库用户表,一张「student」数据库用户表(一个后台管理员用户表和一个前台学生用户表),现在你可以使用 Auth 方法来实现后台用户和学生用户的独立登录而不相互影响。

用户认证脚手架#

此前 Laravel 后端认证处理已经是相当容易了,现在 Laravel 5.2 提供了一个更加便捷、快速的方法来创建前台认证视图,只需要简单的在终端执行 make:auth 命令即可。

php artisan make:auth

该命令会生成纯文本的、兼容 Bootstrap 样式的视图用于登录、注册和密码重置。该命令还会顺带在路由文件中增加对应的授权路由。

{note} 该功能特性只能用于新创建的应用,不能用于升级后的应用。

隐式数据模型绑定#

隐式模型绑定使得在路由和控制器中注入模型实例更加便捷。例如,假设你定义了一个如下的路由:

use App\User;

Route::get('/user/{user}', function (User $user) {
    return $user;
});

在 Laravel 5.1 中,你通常需要通过 Route::model 方法告诉 Laravel 注入 App\User 实例以匹配路由定义中的 {user} 参数。

现在,在 Laravel 5.2 中,框架将会基于相应 URI 判断 自动 注入模型,从而允许你快速访问需要的模型实例。

如路由参数片段 {user} 匹配到 路由闭包控制器方法 中对应参数 $user,且类型提示为 Eloquent 数据模型的话,Laravel 将会自动注入该模型。

更多隐式模型绑定信息,请查看 HTTP 路由模型绑定部分

中间件群组#

中间件群组允许你将多个路由中间件组织到单一、方便的键 (即群组名称)下面,从而可以为某个路由一次指派多个中间件。例如,在同一个应用中构建 Web UI 或 API 时,这一特性很有用。例如,你可以将 session 及 CSRF 路由組合成一个 web 群组,并将访问频率限制分组到 api 群组。

实际上,默认的 Laravel 5.2 应用结构采用的正是这种方法。例如,在默认的 App\Http\Kernel.php 文件中你会看到如下内容:

/**
 * 路由中间件群组
 *
 * @var array
 */
protected $middlewareGroups = [
    'web' => [
        \App\Http\Middleware\EncryptCookies::class,
        \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
        \Illuminate\Session\Middleware\StartSession::class,
        \Illuminate\View\Middleware\ShareErrorsFromSession::class,
        \App\Http\Middleware\VerifyCsrfToken::class,
    ],

    'api' => [
        'throttle:60,1',
    ],
];

然后,web 组可以这样指定给路由:

Route::group(['middleware' => ['web']], function () {
    //
});

默认的,所有的 app/Http/routes.php 中的路由 已经RouteServiceProvidermapWebRoutes 方法中指定了 web 中间件组,所以你不必重复指定。

访问频率限制#

框架现在内置了一个新的访问频率限制中间件,允许你轻松控制给定 IP 地址在指定时间内对某个路由发起请求的数目。

例如,要限制某个 IP 地址每分钟只能访问某个路由 60 次,你可以这么做:

Route::get('/api/users', ['middleware' => 'throttle:60,1', function () {
    //
}]);

数组输入验证#

在 Laravel 5.2 中,可轻松验证表单中的每一个数组输入字段。例如,要验证指定数组输入字段中每一个 email 是否唯一,可以这么实现:

$validator = Validator::make($request->all(), [
    'person.*.email' => 'email|unique:users'
]);

同样的,你可以使用「 *」 符号来指定要验证数组字段,自定义验证数组字段的错误消息提醒:

'custom' => [
    'person.*.email' => [
        'unique' => '用户的 Email 必须是唯一的',
    ]
],

Bail 认证规则#

Laravel 5.2 新添加了一个 bail 认证规则,此规则会在第一个失败认证后停止后面的其他认证检查。例如:你想在 integer 数值检查失败后停止对 unique 唯一性的检查:

$this->validate($request, [
    'user_id' => 'bail|integer|unique:users'
]);

Eloquent 全局作用域优化#

在之前的 Laravel 版本中,Eloquent 全局作用域的实现复杂且容易出错,但在 Laravel 5.2 中,全局查询作用域只需实现一个简单的 apply 方法即可。

更多关于全局作用域的使用,请查阅 Eloquent 文档.

Laravel 5.1.11#

Laravel 5.1.11 推出了内置的 授权 功能!利用回调和授权策略类,能更方便的组织应用程序的授权逻辑。

更多的信息请参考 授权的文档

Laravel 5.1.4#

Laravel 5.1.4 增加了简单的登录限制功能。查阅 认证的文档 以获取更多信息。

Laravel 5.1#

Laravel 5.1 由 Laravel 5.0 改进而成,变更包括但是不限于:

  • 采用 PSR-2 规范
  • 支持添加事件广播
  • 中间件参数
  • Artisan 的改进等等。

PHP 5.5.9+#

由于 PHP 5.4 将在九月「结束寿命」,PHP 开发团队不再提供安全性更新,所以 Laravel 要求 PHP 5.5.9 或更高的版本。

PHP 5.5.9 同时也是最新版本的 PHP 函数库,像是 Guzzle 及 AWS SDK 需要的最小版本需要。

LTS#

Laravel 5.1 是 Laravel 生态系统中第一个 长期支持 版本。Laravel 5.1 会获得两年的 BUG 修复及三年的安全性修复,此策略也使 Laravel 能更好的服务于较大型的企业客户及消费者。

PSR-2#

PSR-2 代码风格指南 已经被 Laravel 框架采用为默认的代码风格指南。此外,所有的生成器都已进行更新,生成的文件将兼容 PSR-2 规范。

文档#

Laravel 文档的每一页已被精心审阅,并得到显著的改善。所有的代码例子也进行了严密检查,使其有更高的上下文关联性。

事件广播#

WebSockets 技术越来越多的被现代 Web 应用使用,当服务器上一些数据更新,WebSocket 会实时发送一个消息给客户端,实现即时更新用户状态功能。

Laravel 的事件广播机制很好的支持了此类应用的开发,广播事件允许服务器端代码和 JavaScript 框架间分享相同的事件名称。

了解更多关于事件广播,请查阅 事件的文档

中间件参数#

中间件支持接收自定义传参,例如要在运行特定操作之前,检查当前登录的用户是否具备「某角色」,可以创建 RoleMiddleware 来接收角色名称作为传参:

<?php

namespace App\Http\Middleware;

use Closure;

class RoleMiddleware
{
    /**
     * 运行请求过滤。
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @param  string  $role
     * @return mixed
     */
    public function handle($request, Closure $next, $role)
    {
        if (! $request->user()->hasRole($role)) {
            // 重定向...
        }

        return $next($request);
    }

}

在路由中使用冒号 : 来区隔中间件名称与参数,多个参数可使用逗号作为分隔:

Route::put('post/{id}', ['middleware' => 'role:editor', function ($id) {
    //
}]);

关于中间件的更多信息,请查阅 中间件的文档

测试改进#

Laravel 内置的测试功能已得到显著的改善,新版本提供了简明的接口与应用程序进行交互,响应检查也变得更加轻松。

例如下方的测试:

public function testNewUserRegistration()
{
    $this->visit('/register')
         ->type('Taylor', 'name')
         ->check('terms')
         ->press('Register')
         ->seePageIs('/dashboard');
}

关于测试的更多信息,请查阅 测试的文档

模型工厂#

Laravel 的 模型工厂 提供一种简单的方式来创建仿真 Eloquent 模型。

在为 Eloquent 模型定义一组「默认」填充字段后,即可为测试,或者数据填充生成测试模型实例。

另外,模型工厂支持使用 Faker 来生成随机数据:

$factory->define(App\User::class, function ($faker) {
    return [
        'name' => $faker->name,
        'email' => $faker->email,
        'password' => str_random(10),
        'remember_token' => str_random(10),
    ];
});

更多关于模型工厂的信息,请查阅 它的文档

Artisan 的改进#

Artisan 命令现支持类似于命名路由的定义,以简单易懂的形式来定义命令行的参数及选项。

举个例子,你可以定义一个简单的命令及它的参数和选项,如下:

/**
 * 命令行的名字及署名。
 *
 * @var string
 */
protected $signature = 'email:send {user} {--force}';

更多关于定义 Artisan 命令的消息,请参考 Artisan 的文档

文件夹结构#

为了更方便理解,app/Commands 目录已经被更名为 app/Jobs

此外,app/Handler 目录已经被合并成一个只包含事件侦听器的 app/Listeners 目录中。

这不是一个重大的改变,你不必更新成新的文件夹结构也能使用 Laravel 5.1。

加密#

在 Laravel 之前的版本,加密是通过 mcrypt PHP 扩展进行处理。不过,从 Laravel 5.1 起,加密将采用更积极维护的 openssl 扩展进行处理。

Laravel 5.0#

Laravel 5.0 引进了新的应用程序架构。新架构允许 Laravel 创建更加健壮的应用程序,新架构全面采用新的自动加载标准(PSR-4)。

以下是一些主要变化:

新的目录结构#

旧的 app/models 目录已经完全被移除。对应的,你所有的代码都放在 app 目录下。

默认情况下使用 App 命名空间。可以使用 app:name Artisan 命令对默认命名空间进行修改。

控制器、中间件,以及表单请求(Laravel 5.0 中新型态的类),分门别类的放在 app/Http 目录下,因为他们都与应用程序的 HTTP 传输层相关。除了一个路由设置的文件外,所有中间件现都分开为独自的类文件。

app/Providers 目录取代了旧版 Laravel 4.x app/start 里的文件。这些服务提供者为应用程序提供了各种引导功能,像是错误处理,日志纪录,路由加载等等。当然,你可以任意的创建新的服务提供者。

应用程序的语言文件和视图都被移到 resources 目录下。

Contracts#

所有 Laravel 组件实现所用的接口都放在 illuminate/contracts 文件夹中,他们没有其他依赖。这些方便集成的接口,让依赖注入变得低耦合,可简单作为 Laravel Facades 的替代选项。

更多关于 contracts 的信息,参考 完整文档

路由缓存#

如果你的应用程序全部使用控制器路由,新的 route:cache Artisan 命令可大幅度地优化路由注册寻找速度。

这对于拥有 100 个以上路由规则的应用程序来说很有用,可以 大幅度地 加快应用程序路由部分的处理速度。

路由中间件#

除了像 Laravel 4 风格的路由「过滤器」,Laravel 5 现在有 HTTP 中间件,而原本的认证和 CSRF 「过滤器」已经改写成中间件。中间件提供了单个、一致的接口取代了各种过滤器,让你在请求进到应用程序前,可以简单地检查甚至拒绝请求。

更多关于中间件的信息,参考 完整文档

控制器方法注入#

除了之前有的类的构造函数注入外,你现在可以在控制器方法中使用依赖注入。服务容器 会自动注入依赖,即使路由包含了其它参数也不成问题:

public function createPost(Request $request, PostRepository $posts)
{
    //
}

认证基本架构#

认证系统默认包含了用户注册,认证,以及重设密码的控制器,还有对应的视图,视图文件存放在 resources/views/auth

除此之外,「users」数据表迁移也默认包含在框架中。这些简单的资源,可以让你把心思放在产品开发上,而不用陷在编写认证模板的泥潭。

认证相关的视图可以通过 auth/login 以及 auth/register 路由访问。

App\Services\Auth\Registrar 会负责处理用户认证和注册用户的相关逻辑。

事件对象#

你现在可以将事件定义成对象,而不是仅使用字符串。例:

<?php

class PodcastWasPurchased
{
    public $podcast;

    public function __construct(Podcast $podcast)
    {
        $this->podcast = $podcast;
    }
}

这个事件可以像一般使用那样被派发:

Event::fire(new PodcastWasPurchased($podcast));

当然,你的事件处理会收到事件的对象而不是数据的列表:

<?php

class ReportPodcastPurchase
{
    public function handle(PodcastWasPurchased $event)
    {
        //
    }
}

更多关于使用事件的信息,参考 完整文档

命令及队列#

除了 Laravel 4 形式的队列任务,Laravel 5 还支持命令对象直接作为队列任务。这些命令放在 app/Commands 目录下。下面是个例子的命令:

<?php

class PurchasePodcast extends Command implements SelfHandling, ShouldBeQueued
{

    use SerializesModels;

    protected $user, $podcast;

    /**
     * Create a new command instance.
     *
     * @return void
     */
    public function __construct(User $user, Podcast $podcast)
    {
        $this->user = $user;
        $this->podcast = $podcast;
    }

    /**
     * Execute the command.
     *
     * @return void
     */
    public function handle()
    {
        // Handle the logic to purchase the podcast...

        event(new PodcastWasPurchased($this->user, $this->podcast));
    }
}

Laravel 的基底控制器使用了新的 DispatchesCommands trait,让你可以简单的派发命令运行:

$this->dispatch(new PurchasePodcastCommand($user, $podcast));

当然,你也可以将命令视为同步运行(而不会被放到队列里)的任务。事实上,「命令总线」是个不错的设计模式,可以封装应用程序需要运行的复杂任务。更多相关的信息,参考 command bus 文档。

数据库队列#

database 队列驱动现在已经包含在 Laravel 中了,提供了简单的本地端队列驱动,除了数据库相关软件外不需安装其它扩展包,完全开箱即用。

Laravel 调度器#

在过去,开发者是在 crontab 里配置任务调度的。然而,这是件很头痛的事情,因为你的命令行调度不在版本控制中,并且必须登录到服务器里才能添加新的 Cron 设置。

Laravel 命令行调度的存在,就是为了改变这一情况。

命令行调度系统让你在 Laravel 里定义富有表达性的命令调度,而且只需要在服务器里设置一个 Cron 设置即可。

看起来如下:

$schedule->command('artisan:command')->dailyAt('15:00');

参考 完整文档 学习所有调度相关知识。

Tinker 与 Psysh#

php artisan tinker 命令现在使用 Justin Hileman 的 Psysh,一个 PHP 更强大的 REPL。如果你喜欢 Laravel 4 的 Boris,你也会喜欢上 Psysh。更好的是,它可以在 Windows 上运行!

赶快尝试下吧:

php artisan tinker

DotEnv#

比起一堆令人困惑的、嵌套的环境配置文件,Laravel 5 现在使用了 Vance Lucas 的 DotEnv

这个扩展包提供了超级简单的方式管理配置文件,并且让 Laravel 5 环境侦测变得轻松。更多的细节,参考完整的 配置文件文档

Laravel Elixir#

Jeffrey Way 的 Laravel Elixir 提供了一个流畅、口语化的接口,可以编译以及合并静态资源。如果你曾经因为学习 Grunt 或 Gulp 而被吓到,不必再害怕了。Elixir 让使用 Gulp 编译 Less、Sass 及 CoffeeScript 变得简单。它甚至可以帮你运行测试!

更多关于 Elixir 的信息,参考 完整文档

Laravel Socialite#

Laravel Socialite 是可选的,兼容 Laravel 5.0 以上的 OAuth 认证扩展包。目前 Socialite 支持 Facebook、Twitter、Google 以及 GitHub。它写起来是这样的:

public function redirectForAuth()
{
    return Socialize::with('twitter')->redirect();
}

public function getUserFromProvider()
{
    $user = Socialize::with('twitter')->user();
}

不再需要花上数小时编写 OAuth 的认证流程,只要几分钟!查看 完整文档 里有所有的细节。

文件系统集成#

Laravel 现在包含了强大的 Flysystem 文件系统(一个文件系统的抽象函数库)。

文件系统以抽象的概念,把本地端文件系统、Amazon S3 和 Rackspace 云存储集成在一起,统一且优雅的 API!

现在要将文件存到 Amazon S3 相当简单:

Storage::put('file.txt', 'contents');

更多关于 Laravel 文件系统集成,参考 完整文档

Form Requests#

Laravel 5.0 引进了 form requests,是继承自 Illuminate\Foundation\Http\FormRequest 的类。这些 request 对象可以和控制器方法依赖注入结合使用,提供一个不需模版的方法,来验证用户输入。让我们深入点,看一个 FormRequest 的例子:

<?php

namespace App\Http\Requests;

class RegisterRequest extends FormRequest
{
    public function rules()
    {
        return [
            'email' => 'required|email|unique:users',
            'password' => 'required|confirmed|min:8',
        ];
    }

    public function authorize()
    {
        return true;
    }
}

定义好类后,我们可以在控制器动作里使用类型提示进行依赖注入:

public function register(RegisterRequest $request)
{
    var_dump($request->input());
}

当 Laravel 的服务容器辨别出要注入的类是个 FormRequest 实例,该请求将会被 自动验证。意味着,框架会自动根据你在 form request 类里自定的规则,对请求进行检验。当控制器动作调用时,你可以安全的假设 HTTP 的请求输入己被验证过。

甚至,若这个请求验证不通过,一个 HTTP 重定向(可以自定义),会自动发出,错误消息可以被闪存到 session 中或是转换成 JSON 返回。表单验证再简单不过了。 更多关于 FormRequest 验证,请参考 文档

简易控制器请求验证#

Laravel 5 基底控制器包含一个 ValidatesRequests trait。这个 trait 包含了一个简单的 validate 方法可以验证请求。如果对你的应用程序来说 FormRequests 太复杂了,可以考虑使用手动验证方法:

public function createPost(Request $request)
{
    $this->validate($request, [
        'title' => 'required|max:255',
        'body' => 'required',
    ]);
}

如果验证失败,会抛出异常以及返回适当的 HTTP 响应到浏览器。验证错误信息会被闪存到 session 里!而如果请求是 AJAX 请求,Laravel 会自动返回 JSON 格式的验证错误信息。

更多关于这个新方法的信息,参考 这个文档

新的生成器#

为了响应新的应用程序默认架构,框架新增了许多 Artisan generator 命令。使用 php artisan list 查看完整的命令列表。

配置文件缓存#

你现在可以通过 config:cache 命令将所有的配置文件缓存在单个文件中,这样在一定程度上会加快框架的启动效率。

Symfony VarDumper#

广为使用的 dd 辅助函数,用作在调试时输出变量信息,现采用令人惊艳的 Symfony VarDumper 扩展包。它提供了颜色标记的输出,甚至数组可以自动缩合。在项目中试试下列代码:

dd([1, 2, 3]);

Laravel 4.2#

此发行版本的完整的变更列表可以通过运行 php artisan changes 命令来获取,或者 Github 上的更动纪录。此纪录仅含括主要更新和此发行的更动部分。

附注: 在 4.2 开发期间,许多小的 BUG 修正与功能强化被整合至各个 4.1 的子发行版本中。所以,也请一并检查 Laravel 4.1 版本的更新列表。

PHP 5.4 需求#

Laravel 4.2 需要 PHP 5.4 以上的版本。此 PHP 更新版本让我们可以使用 PHP 的新功能:traits 来为像是 Laravel 收银台 来提供更具表达力的接口。PHP 5.4 也比 PHP 5.3 带来显著的速度及性能提升。

Laravel Forge#

Larvel Forge,一个网页应用程序,提供一个简单的接口让你创建管理云端上的 PHP 服务器,像是 Linode、DigitalOcean、Rackspace 和 Amazon EC2。

支持自动化 nginx 设置、SSH 密钥管理、Cron job 自动化、通过 NewRelic & Papertrail 服务器监控、「推送部署」、Laravel queue worker 设置等等。Forge 提供最简单且更实惠的方式来部署所有你的 Laravel 应用程序。

默认 Laravel 4.2 的安装里,app/config/database.php 配置文件已为 Forge 设置完成,让你更方便的完成新平台上的全新应用程序的部署。

关于 Laravel Forge 的更多信息可以在 官方 Forge 网站 上找到。

Laravel Homestead#

Laravel Homestead 是一个健全的 Laravel 和 PHP 应用程序 Vagrant 环境。软件依赖都已提前准备好,可以极快的被启用。

Homestead 包含 Nginx 1.6、PHP 5.5.12、MySQL、Postres、Redis、Memcached、Beanstalk、Node、Gulp、Grunt 和 Bower。Homestead 包含一个简单的 Homestead.yaml 配置文件,允许你在单个封装包中管理多个 Laravel 应用程序。

默认的 Laravel 4.2 安装中包含的 app/config/local/database.php 配置文件已经为你配置好了 Homestead 的数据库连接。让 Laravel 初始化安装与设置更为方便。

官方文档已经更新并包含在 Homestead 文档 中。

Laravel 收银台#

Laravel 收银台是一个简单、具表达性的资源库,用来管理 Stripe 的订阅服务。虽然安装此组件是可选的,我们仍然将收银台文档包含在主要 Laravel 文档中。新版本的收银台带来了数个错误修正、多货币支持还有支持了最新的 Stripe API。

Queue Workers 常驻程序#

Artisan queue:work 命令现在支持 --daemon 参数让 worker 可以作为「常驻程序」启用。代表 worker 可以持续的处理队列工作,而不需要重启框架。这让一个复杂的应用程序对 CPU 的使用率有显著的降低。

更多关于 Queue Workers 常驻程序信息请详阅 queue 文档

Mail API Drivers#

Laravel 4.2 为 Mail 类采用了新的 Mailgun 和 Mandrill API 驱动。对许多应用程序而言,他提供了比 SMTP 更快也更可靠的方法来递送邮件。新的驱动使用了 Guzzle 4 HTTP 资源库。

软删除 Traits#

PHP 5.4 的 traits 提供了一个更加简洁的软删除架构和全局作用域,这些新架构为框架提供了更有扩展性的功能,并且让框架更加简洁。

更多关于软删除的文档请见: Eloquent documentation

更为方便的 认证 (auth) & Remindable Traits#

得益于 PHP 5.4 traits,我们有了一个更简洁的用户认证和密码提醒接口,这也让 User 模型文档更加精简。

"简易分页"#

一个新的 simplePaginate 方法已被加入到查找以及 Eloquent 查找器中。让你在分页视图中,使用简单的「上一页」和「下一页」链接查找更为高效。

迁移确认#

在正式环境中,破坏性的迁移动作将会被再次确认。如果希望取消提示字符确认请使用 --force 参数。

Laravel 4.1#

完整更动列表#

此发行版本的完整更动列表,可以在版本 4.1 的安装中命令行运行 php artisan changes 获取,或者浏览 Github 更新文件中 中了解。其中只记录了该版本比较主要的强化功能和更动。

新的 SSH 组件#

一个全新的 SSH 组件在此发行版本中登场。此功能让你可以轻易的 SSH 至远程服务器并运行命令。更多信息,可以参阅 SSH 组件文档

新的 php artisan tail 命令就是使用这个新的 SSH 组件。更多的信息,请参阅 tail 命令集文档

Boris In Tinker#

如果你的系统支持 Boris REPLphp artisan thinker 命令将会使用到它。系统中也必须先行安装好 readlinepcntl 两个 PHP 扩展包。如果你没这些扩展包,从 4.0 之后将会使用到它。

Eloquent 强化#

Eloquent 添加了新的 hasManyThrough 关系链。想要了解更多,请参见 Eloquent 文档

一个新的 whereHas 方法也同时登场,他将允许 检索基于关系模型

数据库读写分离#

Query Builder 和 Eloquent 目前通过数据库层,已经可以自动做到读写分离。更多的信息,请参考 文档

队列排序#

队列排序已经被支持,只要在 queue:listen 命令后将队列以逗号分隔送出。

失败队列作业处理#

现在队列将会自动处理失败的作业,只要在 queue:listen 后加上 --tries 即可。更多的失败作业处理可以参见 队列文档

缓存标签#

缓存「区块」已经被「标签」取代。缓存标签允许你将多个「标签」指向同一个缓存对象,而且可以清空所有被指定某个标签的所有对象。更多使用缓存标签信息请见 缓存文档

更具弹性的密码提醒#

密码提醒引擎已经可以提供更强大的开发弹性,如:认证密码、显示状态消息等等。使用强化的密码提醒引擎,更多的信息 请参阅文档

强化路由引擎#

Laravel 4.1 拥有一个完全重新编写的路由层。API 一样不变。然而与 4.0 相比,速度快上 100%。整个引擎大幅的简化,且路由表达式大大减少对 Symfony Routing 的依赖。

强化 Session 引擎#

此发行版本中,我们亦发布了全新的 Session 引擎。如同路由增进的部分,新的 Session 层更加简化且更快速。我们不再使用 Symfony 的 Session 处理工具,并且使用更简单、更容易维护的自定义解法。

Doctrine DBAL#

如果你有在你的迁移中使用到 renameColumn,之后你必须在 composer.json 里加 doctrine/dbal 进依赖扩展包中。此扩展包不再默认包含在 Laravel 之中。


{note} 欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。

转载请注明:本文档由 Laravel China 社区 [laravel-china.org] 组织翻译,详见 翻译召集帖

文档永久地址: d.laravel-china.org

本文章首发在 LearnKu.com 网站上。

上一篇 下一篇
《L04 微信小程序从零到发布》
从小程序个人账户申请开始,带你一步步进行开发一个微信小程序,直到提交微信控制台上线发布。
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
讨论数量: 8
发起讨论 只看当前版本


AIR
get: fn 这是什么语法?js 中才有吧?
0 个点赞 | 4 个回复 | 问答 | 课程版本 9.x
Sher
请教下本站文档设计实现。
0 个点赞 | 4 个回复 | 问答 | 课程版本 8.5
jianghushusheng
短信频率
0 个点赞 | 3 个回复 | 代码速记 | 课程版本 8.x
xiwang6428
9 版本不是 LTS?
0 个点赞 | 2 个回复 | 问答 | 课程版本 9.x
小红
七牛云存储
0 个点赞 | 0 个回复 | 代码速记 | 课程版本 8.x
kang_lin
exce 数据导出
0 个点赞 | 0 个回复 | 代码速记 | 课程版本 7.x
killthat
composer require symfony/r-http-message-bridge
0 个点赞 | 0 个回复 | 代码速记 | 课程版本 8.x