Laravel 5.3 中文文档 on 七三的小站

Laravel 5.3 中文文档：快速入门——安装

Wed, 21 Sep 2016 00:00:00 +0800

安装

安装

安装

运行环境要求

Laravel 框架会有一些系统上的要求。当然，这些要求在 Laravel Homestead 虚拟机上都已经完全配置好了，强烈建议使用 Homestead 作为本地开发环境。

不过，如果你没有使用 Homestead，那么需要保证运行环境满足以下要求：

- PHP >= 5.6.4 - OpenSSL PHP Extension - PDO PHP Extension - Mbstring PHP Extension - Tokenizer PHP Extension

译者注：强烈推荐使用 Homestead 作为开发环境，尤其是新手，可以避免很多不必要的麻烦。线上环境可以参考 Homestead 的环境部署脚本进行部署。

安装 Laravel

Laravel 使用 Composer 来管理代码依赖。所以，在使用 Laravel 之前，请先确认你的电脑上安装了 Composer。

通过 Laravel 安装工具

首先，通过 Composer 安装 Laravel 安装工具：

composer global require "laravel/installer"

请确保 ~/.composer/vendor/bin 目录 (或者你操作系统类似的目录) 在你的系统环境变量中，这样 laravel 才可以在你系统任意路径调用运行。

译者注：例如 windwos 系统，该目录是 C:/Users/xxxx/AppData/Roaming/Composer

一旦安装完成，就可以使用 laravel new 命令在指定目录创建一个新的 Laravel 项目，例如：laravel new blog 将会在当前目录下创建一个叫 blog 的新应用，此目录里面存放着新安装的 Laravel 和代码依赖。

laravel new blog

译者注：通过这种方式安装，速度要比通过 Composer 安装要快上许多，因为代码依赖是直接一起打包安装的。

通过 Composer Create-Project

除此之外，你也可以通过 Composer 在命令行运行 create-project 命令来安装 Laravel：

composer create-project --prefer-dist laravel/laravel blog

译者注：如果要下载其他版本，比如 5.1 LTS 版本，可以使用这个命令：

composer create-project --prefer-dist laravel/laravel blog 5.1.*

本地开发服务器

如果你在本地安装了 PHP ，想使用 PHP 内置的 Web 服务器访问应用。你需要使用 serve Artisan 命令。这个命令会启动 PHP 内置的开发服务器，通过 http://localhost:8000 访问。

php artisan serve

当然，了解更多本地开发选项，请阅读文档 Homestead 和 Valet。

配置信息

Public 目录

安装完成后，你应该指定 Web 服务器的网站根目录到 public 文件夹上。在这个文件夹下的 index.php 文件是所有 HTTP 请求的入口控制文件。

配置文件

所有 Laravel 框架的配置文件都放置在 config 目录下。每个选项都有说明，请仔细阅读这些说明，并熟悉这些选项配置。

目录权限

安装 Laravel 之后，你必须设置一些文件目录权限。storage 和 bootstrap/cache 目录必须让 Web 服务有写入权限。否则 laravel 将无法运行。如果你使用 Homestead 虚拟机，那么这些权限已经被设置好了。

应用程序密钥

安装完 Laravel 后，下一步要做的事情是将应用程序密钥设置为一个随机字符串。假设你是通过 Composer 或是 Laravel 安装工具安装的 Laravel，那么这个密钥已经通过 key:generate 命令帮你设置完成。

这个密钥可以被设置在 .env 环境文件中。如果你还没将 .env.example 文件重命名为 .env，那么你现在应该去设置下。

如果应用程序密钥没有被设置的话，你的用户 Session 和其它的加密数据都是不安全的！

其它设置

Laravel 几乎不需做任何其它设置就可以马上使用，但是建议你先浏览 config/app.php 文件和对应的文档，这里面包含着一些选项，如 时区 和 语言环境，你可以根据应用程序的情况来修改。

你也可以设置 Laravel 的几个附加组件，像是：

- [缓存](/laravel-5.3-cache#configuration) - [数据库](/laravel-5.3-database#configuration) - [Session](/laravel-5.3-session#configuration)

一旦 Laravel 安装完成，你应该立即设置本机环境。

最后更新：2016.09.21

Laravel 5.3 中文文档：序言——贡献指南

Tue, 20 Sep 2016 00:00:00 +0800

贡献指南 (Contribution Guide)

Bug 反馈 (Bug Reports)

为了提倡积极协作，Laravel 强烈鼓励使用 GitHub 的 pull requests，而不是仅仅报告 Bug，「Bug 反馈」可以以一个包含失败测试的 Pull Request 的形式发送。

假如你提交了「Bug 反馈」，那么反馈中应该包含着标题和详尽的问题描述，并尽可能多的提供相关的信息和该 Bug 的代码示例。这样做的主要目的是让自己和其他人可以简单地重现并修复该 Bug。

请记住，「Bug 反馈」的初衷是让其它有相同问题的人可以协作解决问题。不要期望反馈 Bug 后，马上就会有人修复了它。创建「Bug 反馈」主要是为了能帮助你自己和其他人开始着手修复问题。

Laravel 源代码托管在 GitHub 上面，并且每一个 Laravel 项目都有其对应的代码仓库：

核心开发讨论 (Core Development Discussion)

你可以在 Laravel 讨论组 issue board 提出新特性或者改进。如果你提出了新的特性，请至少附上完成新特性需要的相关代码。

有关错误、新功能和现有功能的实现讨论会在 Slack 的 LaraChat 群组上的 #internals 频道中进行。Laravel 的维护者 Taylor Otwell 在工作日的上午8点到下午5点（西六区或美国芝加哥时间）通常会出现在频道上，其它时间也可能偶尔在线。

选择分支 (Which Branch?)

所有的 Bug 修复应该提交到 latest stable 稳定分支上。Bug 修复 永远不要 提交到 master 分支，除非它修复的功能只存在下一版的发布中。

次要的 且与现有的 Laravel 发布版本 完全向下兼容 的功能可以发送到最新的稳定分支。

主要的 新功能应该都发送到 master 分支，它包含下一版的 Laravel 发布内容。

如果不确定你的功能是主要的还是次要的，请在 Slack 的 LaraChat 群组上的 #internals 频道询问 Taylor Otwell。

安全漏洞 (Security Vulnerabilities)

如果你发现 Laravel 存在安全漏洞，请发送电子邮件到 taylor@laravel.com 给 Taylor Otwell。所有的安全漏洞将会被及时解决。

编码风格 (Coding Style)

Laravel 遵守 PSR-2 编码规范和 PSR-4 自动加载规范。

译者注：扩展阅读 - 所有 PSR 的标准规范。

PHPDoc

下面是一个示范文档单元。请注意 @param 属性后有是有两个空格，参数类型两个以上空格，最后是变量类型名称。

/**
 * 为服务容器注册一个绑定
 *
 * @param  string|array  $abstract
 * @param  \Closure|string|null  $concrete
 * @param  bool  $shared
 * @return void
 */
public function bind($abstract, $concrete = null, $shared = false)
{
    //
}

StyleCI

如果你的编码风格不完美，别着急！当你 pull requests 到 Laravel 版本库后， StyleCI 可以自动合并修复任何风格。这使我们能够专注于内容的贡献，而不是编码风格。

最后更新：2016.09.21

Laravel 5.3 中文文档：序言——版本说明

Mon, 19 Sep 2016 00:00:00 +0800

版本说明 (Release Notes)

支持政策 (Support Policy)

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

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

Laravel 的发布路线图 - by Summer

Laravel 5.3

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

消息通知 Laravel Notifications；
事件广播 Laravel Echo；
OAuth2 授权认证 Laravel Passport；
全文搜索引擎 Laravel Scout；
Laravel Elixir 开始支持 Webpack；
Mail 操作类 Laravel Mailable；
web 和 api 的路由分离；
基于闭包的控制台命令；
更加易用的辅助函数，用于存储上传的文件；
支持 POPO 和单动作控制；
优化默认的前端脚手架，等等。

消息通知 (Notifications)

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

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

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

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

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

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

WebSockets / 事件广播 (Event Broadcasting)

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

/*
 * Authenticate the channel subscription...
 */
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 和事件广播(event broadcasting)的信息，请查阅完整文档.

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 界面创建 个人访问令牌 (personal access tokens)。

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

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

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

当然，Passport 还提供了方便的 API 让你定制「Token 访问域 (access token scopes)」：

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

此外，Passport 还包含了一个用于检查「Token 访问域 (access token scopes)」访问权限的中间件：

Route::get('/orders/{order}/status', function (Order $order) {
    // Access token has "check-status" scope...
})->middleware('scope:check-status');

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

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

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

搜索系统 (Laravel Scout)

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

通过模型观察者(model observers)，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 对象 (Mailable Objects)

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

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

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

class WelcomeMessage extends Mailable
{
    use Queueable, SerializesModels;

    /**
     * Build the message.
     *
     * @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 的信息，请查看完整文档。

存储上传文件 (Storing Uploaded Files)

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

存储用户上传文件，在 Web 开发中是一个很常见的任务。Laravel 5.3 提供了一个便捷的 store 方法，只需要对上传文件对象调用此方法，并传参准备存储的路径即可：

/**
 * Update the avatar for the user.
 *
 * @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 。

前端架构 (Frontend Structure)

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

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

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

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

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

路由文件 (Routes Files)

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

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

闭包控制台命令 (Closure Console Commands)

除了通过命令类定义之外，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` 变量 (The `$loop` Variable)

{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 全局作用域；
内置用户认证脚手架支持；
中间件组；
访问频率限制中间件；
数组认证的优化等

用户认证驱动 / “多认证系统 (Multi-Auth)”

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

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

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

用户认证脚手架 (Authentication Scaffolding)

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

php artisan make:auth

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

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

隐式模型绑定 (Implicit Model Binding)

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

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 路由模型绑定部分。

中间件群组 (Middleware Groups)

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

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

/**
 * The application's route middleware groups.
 *
 * @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 中的路由已经在 RouteServiceProvider 的 mapWebRoutes 方法中指定了 web 中间件组，所以你不必重复指定。

访问频率限制 (Rate Limiting)

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

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

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

数组输入验证 (Array Validation)

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

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

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

'custom' => [
    'person.*.email' => [
        'unique' => 'Each person must have a unique e-mail address',
    ]
],

Bail 认证规则 (Bail Validation Rule)

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

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

Eloquent 全局作用域优化 (Eloquent Global Scope Improvements)

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

更多关于全局作用域(global scopes)的信息请查阅完整的 Eloquent 文件

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 规范。

文档 (Documentation)

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

事件广播 (Event Broadcasting)

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

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

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

中间件参数 (Middleware Parameters)

中间件支持接收自定义传参，例如要在运行特定操作之前，检查当前登录的用户是否具备「某角色」，可以创建 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) {
    //
}]);

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

测试改进 (Testing Overhaul)

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

例如下方的测试：

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

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

模型工厂 (Model Factories)

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 Improvements)

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

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

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

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

文件夹结构 (Folder Structure)

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

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

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

加密 (Encryption)

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

Laravel 5.0

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

以下是一些主要变化：

新的目录结构 (New Folder Structure)

旧的 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)

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

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

路由中间件 (Route Middleware)

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

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

控制器方法注入 (Controller Method Injection)

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

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

认证基本架构 (Authentication Scaffolding)

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

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

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

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

事件对象 (Event Objects)

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

<?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)
    {
        //
    }
}

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

命令及队列 (Commands / Queueing)

除了 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...
    }
}

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

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

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

数据库队列 (Database Queue)

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

Laravel 调度器 (Laravel Scheduler)

在过去，开发者是在 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 的认证流程，只要几分钟！查看完整文档里有所有的细节。

文件系统集成 (Flysystem Integration)

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 验证，请参考文档。

简易控制器请求验证 (Simple Controller Request Validation)

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 格式的验证错误信息。

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

新的生成器 (New Generators)

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

配置文件缓存 (Configuration Cache)

你现在可以通过 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 Cashier)

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

常驻程序 (Daemon 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 (Soft Deleting Traits)

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

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

Convenient Auth & Remindable Traits

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

“简易分页 (Simple Paginate)”

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

迁移确认 (Migration Confirmation)

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

Laravel 4.1

完整更动列表 (Full Change List)

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

新的 SSH 组件 (New SSH Component)

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

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

Boris In Tinker

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

Eloquent 强化 (Eloquent Improvements)

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

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

数据库读写分离 (Database Read / Write Connections)

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

队列排序 (Queue Priority)

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

失败队列作业处理 ( Failed Queue Job Handling)

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

缓存标签 (Cache Tags)

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

更具弹性的密码提醒 (Flexible Password Reminders)

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

强化路由引擎 (Improved Routing Engine)

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

强化 Session 引擎 (Improved Session Engine)

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

Doctrine DBAL

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

最后更新：2016.09.21

Laravel 5.3 中文文档 on 七三的小站

Laravel 5.3 中文文档：快速入门——安装

目录

安装

安装

运行环境要求

安装 Laravel

通过 Laravel 安装工具

通过 Composer Create-Project

本地开发服务器

配置信息

Public 目录

配置文件

目录权限

应用程序密钥

其它设置

Laravel 5.3 中文文档：序言——贡献指南

目录

贡献指南 (Contribution Guide)

Bug 反馈 (Bug Reports)

核心开发讨论 (Core Development Discussion)

选择分支 (Which Branch?)

安全漏洞 (Security Vulnerabilities)

编码风格 (Coding Style)

PHPDoc

StyleCI

Laravel 5.3 中文文档：序言——版本说明

目录

版本说明 (Release Notes)

支持政策 (Support Policy)

Laravel 5.3

消息通知 (Notifications)

WebSockets / 事件广播 (Event Broadcasting)

Laravel Passport (OAuth2 认证服务)

搜索系统 (Laravel Scout)

Mailable 对象 (Mailable Objects)

存储上传文件 (Storing Uploaded Files)

Webpack & Laravel Elixir

前端架构 (Frontend Structure)

路由文件 (Routes Files)

闭包控制台命令 (Closure Console Commands)

Blade 中的 $loop 变量 (The $loop Variable)

Laravel 5.2

用户认证驱动 / “多认证系统 (Multi-Auth)”

用户认证脚手架 (Authentication Scaffolding)

隐式模型绑定 (Implicit Model Binding)

中间件群组 (Middleware Groups)

访问频率限制 (Rate Limiting)

数组输入验证 (Array Validation)

Bail 认证规则 (Bail Validation Rule)

Eloquent 全局作用域优化 (Eloquent Global Scope Improvements)

Laravel 5.1

PHP 5.5.9+

LTS

PSR-2

文档 (Documentation)

事件广播 (Event Broadcasting)

中间件参数 (Middleware Parameters)

测试改进 (Testing Overhaul)

模型工厂 (Model Factories)

Artisan 的改进 (Artisan Improvements)

文件夹结构 (Folder Structure)

加密 (Encryption)

Laravel 5.0

新的目录结构 (New Folder Structure)

契约 (Contracts)

路由缓存 (Route Cache)

路由中间件 (Route Middleware)

控制器方法注入 (Controller Method Injection)

认证基本架构 (Authentication Scaffolding)

事件对象 (Event Objects)

命令及队列 (Commands / Queueing)

数据库队列 (Database Queue)

Laravel 调度器 (Laravel Scheduler)

Tinker / Psysh

DotEnv

Laravel Elixir

Laravel Socialite

文件系统集成 (Flysystem Integration)

表单请求 (Form Requests)

Blade 中的 `$loop` 变量 (The `$loop` Variable)