Laravel 5.0 发布 新版本特性详解

译注: 期待 Laravel 5.0 已经很久很久了, 之前跳票说要到今年一月份发布. 从一月份就一直在刷新官网和博客, 始终没有更新的消息, 前几天终于看到官网文档切换到了 5.0 版. 新版本带来了众多令人激动的新特性, 尤其是定时任务队列和表单请求两个特性, 光看一下更新说明中的简单介绍都忍不住要上手尝试了. 今天总算抽出一点时间把官方的新特性说明文档简单地翻译了一下, 希望所有喜欢 Laravel 框架的朋友都能感受到这个版本带来的激动人心的改变. 当然, 如果你需要的是 Phalcon 那样的性能, 那它肯定不是你需要的. 如果你是因为虚拟主机不支持 php 5.4 而不能享受 Laravel, 那你还不扔了你的虚拟主机??? 阿里云\腾讯云\linode... VPS的选择不要太多...

Laravel 5.0

Laravel 5.0 引入了全新的项目目录结构. 新的目录结构更有利于用 Laravel 来创建应用. 5.0 版从头到尾都采用了新的 PSR-4 自动加载标准. 以下是 5.0 版主要的新特性:

目录结构

以前版本中的 app/models 目录被整个移除. 如今你可以直接把代码放在 app 目录下, 该目录下的所有代码默认会被组织到 app 命名空间. 这个命名空间是可以通过新增加的 Artisan 命令 app:name 来修改的.

Controllers, middleware 和 requests (Laravel 5.0 新增加的一种类) 被组织到 app/Http 目录, 因为他们都是与你应用的 HTTP 传输层相关的类. 与之前把所有路由过滤器放到单一的 filters 文件下不同, 现在所有的 middleware (类似之前的 route filter) 被分别存放到各自自己的类文件中.

新版本中增加了一个 app/Providers 目录来代替之前 4.x 版本的 app/start 文件. 这些 service providers 为应用提供各种各样的引导方法, 比如错误处理, 日志记录, 路由加载等. 除此之外你当然也可以创建额外的 service providers.

应用的语言文件和视图被移到了 resources 目录.

Contracts

Laravel 的所有主要组件都实现了存放在 illuminate/contracts 仓库中的接口. 该仓库没有额外的依赖项. 拥有这样一个方便的, 集中存放的接口集合, 你就可以很容易地通过它来对 Laravel Facades 进行解耦和依赖注入方面的选择和修改.

了解有关 contracts 的更多信息, 可以查看它的完整文档.
路由缓存

如果你的应用由各种各样的控制器路由 (controller routes) 组成, 你可以利用新增的 Artisan 命令 route:cache 大幅度提升路由的注册速度. 这在路由数量超过 100 个的应用中尤其有效, 可以 大幅度 提升整个应用在路由部分的速度.

路由中间件 (Route Middleware)

在 4.0 版风格的路由 "过滤器" 基础上, 新版 5.0 已经支持 HTTP 中间件, Laravel 自带的 "authentication" 和 "filters" 已经被转换成中间件. 中间件为所有类型的过滤器提供了单一接口, 你可以很容易地对请求进行审查和拒绝.

了解有关中间件的更多信息, 可以查看它的完整文档.

控制器方法注入

除了现有的构造器注入以外, 在新版本中还可以在控制器方法中的依赖项进行类型约束. IoC container会自动注入依赖项, 即使在路由包含其它参数的时候也是.

代码如下:

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

认证脚手架

用户注册, 认证以及密码重置控制器已经内置在 5.0 版的网站框架中, 除了控制器以外, 还有简单的视图, 存放在 resources/views/auth 目录. 除此之外, 网站初始框架中还包含了一个 "users" 表的 migration 文件. 这些简单的资源帮助开发者不用在用户认证功能上耗费大量时间. 认证相关的页面可以通过 auth/login 和 auth/register 这两个路由访问. App\Services\Auth\Registrar 服务负责处理创建和认证用户.

事件对象

在新版本中, 你可以把事件定义成对象而不是字符串. 看下面的例子:

代码如下:

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

这个事件可以这样调用:

Event::fire(new PodcastWasPurchased($podcast));
当然, 你的事件处理程序收到的也不再是一个数据列表, 而是一个事件对象:

代码如下:

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

了解有关事件的更多信息, 可以查看它的完整文档.

命令/队列

在 4.0 版支持的任务队列基础上, 5.0 支持把任务队列定义为简单的命令对象. 这些命令存放在 app/Commands 目录. 下面是一个简单的命令示例:

代码如下:

class PurchasePodcast extends Command implements SelfHandling, ShouldBeQueued {
 
    use SerializesModels;
 
    protected $user, $podcast;
 
    /**
     * 创建新的命令实例
     *
     * @return void
     */
    public function __construct(User $user, Podcast $podcast)
    {
        $this->user = $user;
        $this->podcast = $podcast;
    }
 
    /**
     * 执行命令
     *
     * @return void
     */
    public function handle()
    {
        // 处理购买播客视频的逻辑
 
        event(new PodcastWasPurchased($this->user, $this->podcast));
    }
 
}

Laravel 的基础控制器 (base controller) 使用了新的 DispatchesCommands 特性, 允许你很方便地监控命令的执行:

$this->dispatch(new PurchasePodcastCommand($user, $podcast));
当然, 你不仅可以把命令用于任务队列(非同步执行), 也可以用于同步任务. 事实上, 把你的应用需要执行的复杂任务封装成命令是一个很好的选择. 了解有关命令的更多信息, 可以查看命令桥的详细文档.

数据库队列

新版 Laravel 包含 database 队列驱动, 提供简单的, 本地的队列驱动, 无需安装额外的包. (译注:比如让不支持事务的数据库进行类似事务的数据操作)

Laravel 定时任务

在过去, 为了定时执行控制台任务, 开发者必须依赖 Cron 任务. 这带来很大不便. 因为定时任务并不包括在网站的源代码中, 而且必须通过 SSH 登陆到服务器去添加 Cron 任务. 新版 Laravel 的定时任务允许开发者在 Laravel 框架内来定义定时执行的命令, 然后只需要在服务器上定义一个总的 Cron 任务即可.

比如:

代码如下:

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

同样的, 了解更多有关定时任务的信息, 可以查阅完整文档.

Tinker / Psysh

php artisan tinker 命令在新版本中借助了 Justin Heleman 开发的 Psysh. 如果你喜欢 Laravel 4.0 里的 Boris, 你肯定会喜欢 Psysh. Boris 在 Windows 下运行得不好, Psysh 完全支持 Windows! 使用方法和以前一样:

代码如下:

php artisan tinker

DotEnv

在 Laravel 5.0 中, 用 Vance Lucas 实现的 DotEnv替代了以前版本中的嵌套结构, 容易让人困惑的环境配置目录. 这个框架提供了一种非常简单的管理环境配置的方式. 在 Laravel 5.0 中检测和区分不同的运行环境变得轻而易举. 了解更多详情, 请访问完整的配置文档.

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 认证流程, 分分钟轻松搞定. 完整文档包含有关这个可选包的全部细节.

Flysystem 集成

新版 Laravel 还包含了强大的 Flysystem文件处理静态库. 通过这个库, 开发者可以轻易上手, 使用完全一致的 API 来实现本地, Amazon S3 或者 Rackspace 进行文件存储. 比如, 在 Amazon S3 存储一个文件, 可以简单到这样:

代码如下:

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

了解有关 Laravel Flysystem 集成的更多细节, 可以查看它的完整文档

表单请求

Laravel 5.0 带来了全新的 form requests, 它扩展自 Illuminate\Foundation\Http\FormRequest 类. 这些请求对象可以和控制器方法注入相结合, 提供一种全新的验证用户输入的方法. 简单举一个 FormRequest 的示例:

代码如下:

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;
    }
 
}

定义好对应的 FormRequest 扩展类之后, 在控制器方法中可以获得类型提示:

代码如下:

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

当 Laravel 的 IoC container 识别到方法变量的类型时, 它会自动注入 FormRequest 的实例, 于是这个请求会被 自动验证. 这意味着当你的控制器被调用时, 你可以安全地使用该请求中包含的输入数据, 因为他们已经被你在表单请求类中指定的规则进行过验证了. 不仅如此, 如果该请求验证失败, 系统还会自动重定向到你预定义好的路由, 并且包含有错误提示的信息(根据需要写入session, 或者转换为 JSON 格式.) 表单验证从未如此简单过. 了解有关 FormRequest 验证的更多细节, 请查阅文档.

控制器请求简单验证

Laravel 5.0 的控制器基类还包含了一个 ValidatesRequests 的 trait. 该 trait 提供了简单的 validate 方法, 用于验证请求. 如果 FormRequests 对于你的应用来说太重了, 那你就可以用这个轻量版的:

代码如下:

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

如果验证失败, 系统会抛出一个异常, 对应的 HTTP 请求会被自动发送给浏览器. 验证错误也会同时写入 session. 如果请求是用 AJAX 方式发起, Larave 会自动发送一个 JSON 形式的验证错误信息.

了解有关 FormRequest 验证的更多细节, 请查阅文档.

全新的生成器

为了方便生成新的默认应用结构, 全新的 Artisan 生成命令已经被添加到框架中. 你可以通过 php artisan list 查看详细命令.

配置缓存

通过 config:cache 命令, 可以把所有的配置项写入一个缓存文件中.

Symfony VarDumper

用于输出变量信息进行调试的辅助方法 dd, 在新版本中进行了升级, 使用强大的 Symfony VarDumper. 它可以输出带有颜色高亮和数组折叠功能的调试信息. 你可以尝试一下:

代码如下:

dd([1, 2, 3]);