Laravel 5.3 中文文档

简体中文

English

简体中文

English

主题

发布说明 ​

支持政策 ​

对于 LTS 版本，如 Laravel 5.1，提供 2 年的错误修复和 3 年的安全修复。这些版本提供最长的支持和维护窗口。对于一般版本，提供 6 个月的错误修复和 1 年的安全修复。

Laravel 5.3 ​

Laravel 5.3 继续改进 Laravel 5.2，通过添加基于驱动的通知系统、通过 Laravel Echo 提供强大的实时支持、通过 Laravel Passport 提供无痛的 OAuth2 服务器、通过 Laravel Scout 提供全文模型搜索、在 Laravel Elixir 中支持 Webpack、"mailable" 对象、明确分离 web 和 api 路由、基于闭包的控制台命令、存储上传文件的便捷助手、支持 POPO 和单动作控制器、改进的默认前端脚手架等。

通知 ​

NOTE

在 Laracasts 上有一个免费的视频教程可供学习此功能。

Laravel 通知提供了一个简单、富有表现力的 API，用于通过多种传递渠道（如电子邮件、Slack、SMS 等）发送通知。例如，您可以定义一个通知，告知发票已支付，并通过电子邮件和 SMS 发送该通知。然后，您可以使用一个简单的方法发送通知：

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

已经有多种社区编写的驱动用于通知，包括对 iOS 和 Android 通知的支持。要了解更多关于通知的信息，请务必查看完整的通知文档。

WebSockets / 事件广播 ​

虽然事件广播在 Laravel 的早期版本中已经存在，但 Laravel 5.3 版本通过为私有和存在 WebSocket 通道添加通道级别的身份验证，大大改进了这一功能：

php
/*
 * 验证通道订阅...
 */
Broadcast::channel('orders.*', function ($user, $orderId) {
    return $user->placedOrder($orderId);
});

Laravel Echo 是一个新的 JavaScript 包，可以通过 NPM 安装，提供了一个简单、美观的 API，用于在客户端 JavaScript 应用程序中订阅通道并监听服务器端事件。Echo 支持 Pusher 和 Socket.io：

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

除了订阅传统通道，Laravel Echo 还使订阅存在通道变得轻而易举，这些通道提供关于谁在监听给定通道的信息：

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

要了解更多关于 Echo 和事件广播的信息，请查看完整文档。

Laravel Passport (OAuth2 服务器) ​

NOTE

在 Laracasts 上有一个免费的视频教程可供学习此功能。

Laravel 5.3 通过 Laravel Passport 使 API 身份验证变得轻而易举，Passport 为您的 Laravel 应用程序提供了一个完整的 OAuth2 服务器实现，只需几分钟即可完成。Passport 构建在由 Alex Bilbie 维护的 League OAuth2 服务器之上。

Passport 使通过 OAuth2 授权码发放访问令牌变得轻而易举。您还可以允许用户通过 Web UI 创建“个人访问令牌”。为了让您快速入门，Passport 包含 Vue 组件，可以作为您的 OAuth2 仪表板的起点，允许用户创建客户端、撤销访问令牌等：

php
<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 的应用程序请求：

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

此外，Passport 包含有用的中间件，用于验证访问令牌认证请求是否包含必要的令牌范围：

php
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
<?php

namespace App;

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

class Post extends Model
{
    use Searchable;
}

一旦将 trait 添加到模型中，只需保存模型，其信息将与搜索索引保持同步：

php
$order = new Order;

// ...

$order->save();

一旦您的模型被索引，您可以轻松地在所有模型中执行全文搜索。您甚至可以对搜索结果进行分页：

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

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

当然，Scout 还有许多其他功能，详见完整文档。

Mailable 对象 ​

NOTE

在 Laracasts 上有一个免费的视频教程可供学习此功能。

Laravel 5.3 附带对 mailable 对象的支持。这些对象允许您将电子邮件消息表示为简单对象，而不是在闭包中自定义邮件消息。例如，您可以为“欢迎”电子邮件定义一个简单的 mailable 对象：

php
class WelcomeMessage extends Mailable
{
    use Queueable, SerializesModels;

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

一旦定义了 mailable 对象，您可以使用简单、富有表现力的 API 将其发送给用户。Mailable 对象非常适合在扫描代码时发现消息的意图：

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

当然，您还可以将 mailable 对象标记为“可排队”，以便它们在后台由队列工作者发送：

php
class WelcomeMessage extends Mailable implements ShouldQueue
{
    //
}

有关 mailable 对象的更多信息，请务必查看邮件文档。

存储上传文件 ​

NOTE

在 Laracasts 上有一个免费的视频教程可供学习此功能。

在 Web 应用程序中，存储文件的最常见用例之一是存储用户上传的文件，如个人资料图片、照片和文档。Laravel 5.3 使存储上传文件变得非常简单，使用上传文件实例上的新 store 方法。只需调用 store 方法并指定要存储上传文件的路径：

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

    return $path;
}

有关存储上传文件的更多信息，请查看完整文档。

Webpack & Laravel Elixir ​

随着 Laravel 5.3 的发布，Laravel Elixir 6.0 也已发布，内置支持 Webpack 和 Rollup JavaScript 模块打包器。默认情况下，Laravel 5.3 的 gulpfile.js 文件现在使用 Webpack 来编译 JavaScript。完整的 Laravel Elixir 文档包含有关这两个打包器的更多信息：

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

前端结构 ​

NOTE

在 Laracasts 上有一个免费的视频教程可供学习此功能。

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 前端开发的更多信息，请查看新的入门前端文档。

路由文件 ​

默认情况下，新的 Laravel 5.3 应用程序在新的顶级 routes 目录中包含两个 HTTP 路由文件。web 和 api 路由文件提供了更明确的指导，说明如何为 Web 界面和 API 分割路由。api 路由文件中的路由由 RouteServiceProvider 自动分配 api 前缀。

闭包控制台命令 ​

除了可以定义为命令类外，Artisan 命令现在还可以在 app/Console/Kernel.php 文件的 commands 方法中定义为简单的闭包。在新的 Laravel 5.3 应用程序中，commands 方法加载一个 routes/console.php 文件，允许您将控制台命令定义为类似路由的、基于闭包的入口点：

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

有关闭包命令的更多信息，请查看完整的 Artisan 文档。

$loop 变量 ​

NOTE

在 Laracasts 上有一个免费的视频教程可供学习此功能。

在 Blade 模板中循环时，$loop 变量将在循环内部可用。此变量提供了一些有用的信息，例如当前循环索引以及这是否是循环的第一次或最后一次迭代：

php
@foreach ($users as $user)
    @if ($loop->first)
        这是第一次迭代。
    @endif

    @if ($loop->last)
        这是最后一次迭代。
    @endif

    <p>这是用户 {{ $user->id }}</p>
@endforeach

有关更多信息，请查阅完整的 Blade 文档。

Laravel 5.2 ​

Laravel 5.2 继续改进 Laravel 5.1，通过添加多重身份验证驱动支持、隐式模型绑定、简化的 Eloquent 全局作用域、可选的身份验证脚手架、中间件组、速率限制中间件、数组验证改进等。

身份验证驱动 / "多重身份验证" ​

在 Laravel 的早期版本中，默认情况下仅支持基于会话的身份验证驱动，并且每个应用程序不能有多个可认证的模型实例。

然而，在 Laravel 5.2 中，您可以定义额外的身份验证驱动，并定义多个可认证的模型或用户表，并分别控制它们的身份验证过程。例如，如果您的应用程序有一个用于“管理员”用户的数据库表和一个用于“学生”用户的数据库表，您现在可以使用 Auth 方法分别对这些表进行身份验证。

身份验证脚手架 ​

Laravel 已经使处理后端身份验证变得容易；然而，Laravel 5.2 提供了一种方便、快速的方式来为前端生成身份验证视图。只需在终端上执行 make:auth 命令：

php
php artisan make:auth

此命令将为用户登录、注册和密码重置生成简单、兼容 Bootstrap 的视图。该命令还将更新您的路由文件以包含适当的路由。

NOTE

此功能仅用于新应用程序，而不是在应用程序升级期间使用。

隐式模型绑定 ​

隐式模型绑定使得将相关模型直接注入到路由和控制器中变得轻而易举。例如，假设您定义了如下路由：

php
use App\User;

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

在 Laravel 5.1 中，您通常需要使用 Route::model 方法来指示 Laravel 注入与路由定义中的 {user} 参数匹配的 App\User 实例。然而，在 Laravel 5.2 中，框架将自动根据 URI 段注入此模型，使您能够快速访问所需的模型实例。

当路由参数段（{user}）与路由闭包或控制器方法的相应变量名（$user）匹配并且变量是 Eloquent 模型类的类型提示时，Laravel 将自动注入模型。

中间件组 ​

中间件组允许您将多个路由中间件分组到一个方便的键下，从而可以一次性将多个中间件分配给路由。例如，这在构建 Web UI 和 API 时非常有用。您可以将会话和 CSRF 路由分组到 web 组中，可能将速率限制器分组到 api 组中。

事实上，默认的 Laravel 5.2 应用程序结构正是采用这种方法。例如，在默认的 App\Http\Kernel.php 文件中，您会发现以下内容：

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 组分配给路由，如下所示：

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

然而，请记住，web 中间件组已经默认应用于您的路由，因为 RouteServiceProvider 在默认中间件组中包含了它。

速率限制 ​

框架现在包含一个新的速率限制器中间件，允许您轻松限制给定 IP 地址在指定分钟数内对路由的请求次数。例如，要限制单个 IP 地址每分钟 60 次请求，您可以执行以下操作：

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

数组验证 ​

在 Laravel 5.2 中，验证数组表单输入字段变得更加容易。例如，要验证给定数组输入字段中的每个电子邮件是否唯一，您可以执行以下操作：

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

同样，您可以在语言文件中指定验证消息时使用 * 字符，使得为基于数组的字段使用单个验证消息变得轻而易举：

php
'custom' => [
    'person.*.email' => [
        'unique' => '每个人必须有一个唯一的电子邮件地址',
    ]
],

Bail 验证规则 ​

添加了一个新的 bail 验证规则，指示验证器在给定规则的第一个验证失败后停止验证。例如，您现在可以防止验证器在属性未通过 integer 检查时运行 unique 检查：

php
$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 将在 9 月进入“生命终止”状态，并且不再从 PHP 开发团队接收安全更新，Laravel 5.1 需要 PHP 5.5.9 或更高版本。PHP 5.5.9 允许与最新版本的流行 PHP 库（如 Guzzle 和 AWS SDK）兼容。

LTS ​

Laravel 5.1 是第一个获得长期支持的 Laravel 版本。Laravel 5.1 将获得 2 年的错误修复和 3 年的安全修复。这一支持窗口是 Laravel 有史以来提供的最长的，为更大的企业客户和客户提供了稳定性和安心。

PSR-2 ​

PSR-2 编码风格指南已被采用为 Laravel 框架的默认风格指南。此外，所有生成器都已更新为生成符合 PSR-2 的语法。

文档 ​

Laravel 文档的每一页都经过精心审查并大幅改进。所有代码示例也经过审查和扩展，以提供更多的相关性和上下文。

事件广播 ​

在许多现代 Web 应用程序中，Web 套接字用于实现实时、实时更新的用户界面。当服务器上的某些数据更新时，通常会通过 Web 套接字连接发送消息以由客户端处理。

为了帮助您构建这些类型的应用程序，Laravel 使“广播”您的事件变得容易。广播您的 Laravel 事件允许您在服务器端代码和客户端 JavaScript 框架之间共享相同的事件名称。

要了解更多关于事件广播的信息，请查看事件文档。

中间件参数 ​

中间件现在可以接收额外的自定义参数。例如，如果您的应用程序需要验证经过身份验证的用户在执行给定操作之前是否具有给定“角色”，您可以创建一个 RoleMiddleware，该中间件接收角色名称作为额外参数：

php
<?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);
    }

}

在定义路由时可以通过用 : 分隔中间件名称和参数来指定中间件参数。多个参数应以逗号分隔：

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

有关中间件的更多信息，请查看中间件文档。

测试大修 ​

Laravel 的内置测试功能得到了显著改进。各种新方法提供了一种流畅、富有表现力的接口，用于与您的应用程序交互并检查其响应。例如，请查看以下测试：

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

有关测试的更多信息，请查看测试文档。

模型工厂 ​

Laravel 现在附带了一种简单的方法来使用模型工厂创建存根 Eloquent 模型。模型工厂允许您轻松定义 Eloquent 模型的“默认”属性集，然后为您的测试或数据库种子生成测试模型实例。模型工厂还利用强大的 Faker PHP 库生成随机属性数据：

php
$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 命令现在可以使用简单的、类似路由的“签名”定义，这提供了一种极其简单的接口，用于定义命令行参数和选项。例如，您可以像这样定义一个简单的命令及其选项：

php
/**
 * 控制台命令的名称和签名。
 *
 * @var string
 */
protected $signature = 'email:send {user} {--force}';

有关定义 Artisan 命令的更多信息，请查阅Artisan 文档。

文件夹结构 ​

为了更好地表达意图，app/Commands 目录已重命名为 app/Jobs。此外，app/Handlers 目录已合并为一个简单包含事件监听器的 app/Listeners 目录。然而，这不是一个破坏性更改，您不需要更新到新的文件夹结构即可使用 Laravel 5.1。

加密 ​

在 Laravel 的早期版本中，加密由 mcrypt PHP 扩展处理。然而，从 Laravel 5.1 开始，加密由 openssl 扩展处理，该扩展维护得更为积极。

Laravel 5.0 ​

Laravel 5.0 为默认的 Laravel 项目引入了一个全新的应用程序结构。这个新结构为在 Laravel 中构建一个强大的应用程序提供了更好的基础，并在整个应用程序中采用了新的自动加载标准（PSR-4）。首先，让我们来看看一些主要的变化：

新的文件夹结构 ​

旧的 app/models 目录已被完全移除。相反，您的所有代码都直接位于 app 文件夹中，并且默认情况下组织到 App 命名空间中。可以使用新的 app:name Artisan 命令快速更改此默认命名空间。

控制器、中间件和请求（Laravel 5.0 中的新类类型）现在被分组在 app/Http 目录下，因为它们都是与应用程序的 HTTP 传输层相关的类。所有中间件现在都分为各自的类文件，而不是单个、扁平的路由过滤器文件。

新的 app/Providers 目录取代了 Laravel 4.x 版本中的 app/start 文件。这些服务提供者为您的应用程序提供各种引导功能，如错误处理、日志记录、路由加载等。当然，您可以为您的应用程序创建额外的服务提供者。

应用程序语言文件和视图已移至 resources 目录。

合同 ​

所有主要的 Laravel 组件都实现了位于 illuminate/contracts 仓库中的接口。此仓库没有外部依赖项。拥有一个方便的、集中位置的接口集，您可以用于解耦和依赖注入，将作为 Laravel Facades 的一个简单替代选项。

有关合同的更多信息，请查阅完整文档。

路由缓存 ​

如果您的应用程序完全由控制器路由组成，您可以利用新的 route:cache Artisan 命令来大幅加快路由的注册速度。这在具有 100 多个路由的应用程序中尤其有用，并将大幅加快应用程序的这一部分。

路由中间件 ​

除了 Laravel 4 风格的路由“过滤器”外，Laravel 5 现在支持 HTTP 中间件，并且包含的身份验证和 CSRF“过滤器”已转换为中间件。中间件提供了一种单一、一致的接口来替换所有类型的过滤器，允许您在请求进入应用程序之前轻松检查甚至拒绝请求。

有关中间件的更多信息，请查看文档。

控制器方法注入 ​

除了现有的构造函数注入外，您现在可以在控制器方法上进行依赖注入。即使路由包含其他参数，服务容器也会自动注入依赖项：

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

身份验证脚手架 ​

用户注册、身份验证和密码重置控制器现在开箱即用，并且包含简单的相应视图，这些视图位于 resources/views/auth。此外，框架中包含了一个“用户”表迁移。包括这些简单的资源可以快速开发应用程序想法，而不会因身份验证样板代码而拖累。身份验证视图可以在 auth/login 和 auth/register 路由上访问。App\Services\Auth\Registrar 服务负责用户验证和创建。

事件对象 ​

您现在可以将事件定义为对象，而不仅仅是使用字符串。例如，请查看以下事件：

php
<?php

class PodcastWasPurchased
{
    public $podcast;

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

事件可以像往常一样触发：

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

当然，您的事件处理程序将接收事件对象，而不是数据列表：

php
<?php

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

有关使用事件的更多信息，请查看完整文档。

命令 / 队列 ​

除了 Laravel 4 支持的队列作业格式外，Laravel 5 允许您将队列作业表示为简单的命令对象。这些命令位于 app/Commands 目录中。以下是一个示例命令：

php
<?php

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 控制器利用新的 DispatchesCommands trait，允许您轻松调度命令以执行：

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

当然，您还可以使用命令来执行同步（不排队）执行的任务。事实上，使用命令是封装应用程序需要执行的复杂任务的好方法。有关更多信息，请查看命令总线文档。

数据库队列 ​

Laravel 现在包含一个 database 队列驱动，提供一个简单的、本地的队列驱动，只需安装数据库软件即可。

Laravel 调度器 ​

过去，开发人员为他们希望调度的每个控制台命令生成一个 Cron 条目。然而，这是一种麻烦。您的控制台计划不再在源代码控制中，您必须 SSH 到服务器以添加 Cron 条目。让我们的生活更轻松。Laravel 命令调度器允许您在 Laravel 内部流畅且富有表现力地定义命令计划，并且服务器上只需要一个 Cron 条目。

它看起来像这样：

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

当然，请查看完整文档以了解有关调度器的所有信息！

Tinker / Psysh ​

php artisan tinker 命令现在使用 Justin Hileman 的 Psysh，这是一个更强大的 PHP REPL。如果您喜欢 Laravel 4 中的 Boris，您会喜欢 Psysh。更好的是，它在 Windows 上也能工作！要开始使用，只需尝试：

php
php artisan tinker

DotEnv ​

Laravel 5 现在使用 Vance Lucas 的 DotEnv，而不是各种混乱的、嵌套的环境配置目录。此库提供了一种超级简单的方式来管理环境配置，并使 Laravel 5 中的环境检测变得轻而易举。有关更多详细信息，请查看完整的配置文档。

Laravel Elixir ​

Laravel Elixir 由 Jeffrey Way 提供了一种流畅、富有表现力的接口，用于编译和连接您的资产。如果您曾经对学习 Grunt 或 Gulp 感到恐惧，现在不必担心了。Elixir 使使用 Gulp 编译 Less、Sass 和 CoffeeScript 变得轻而易举。它甚至可以为您运行测试！

有关 Elixir 的更多信息，请查看完整文档。

Laravel Socialite ​

Laravel Socialite 是一个可选的、与 Laravel 5.0+ 兼容的包，提供完全无痛的 OAuth 提供者身份验证。目前，Socialite 支持 Facebook、Twitter、Google 和 GitHub。它看起来像这样：

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

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

不再需要花费数小时编写 OAuth 身份验证流程。几分钟内即可开始！完整文档包含所有详细信息。

Flysystem 集成 ​

Laravel 现在包含强大的 Flysystem 文件系统抽象库，提供与本地、Amazon S3 和 Rackspace 云存储的无痛集成 - 所有这些都使用一个统一且优雅的 API！在 Amazon S3 中存储文件现在就像这样简单：

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

有关 Laravel Flysystem 集成的更多信息，请查阅完整文档。

表单请求 ​

Laravel 5.0 引入了表单请求，它们扩展了 Illuminate\Foundation\Http\FormRequest 类。这些请求对象可以与控制器方法注入结合使用，提供一种无样板的方法来验证用户输入。让我们深入了解并查看一个示例 FormRequest：

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

一旦定义了类，我们可以在控制器操作中对其进行类型提示：

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

当 Laravel 服务容器识别出它正在注入的类是 FormRequest 实例时，请求将自动验证。这意味着如果调用了您的控制器操作，您可以安全地假设 HTTP 请求输入已根据您在表单请求类中指定的规则进行了验证。更重要的是，如果请求无效，将自动发出 HTTP 重定向，您可以自定义，并且错误消息将被闪存到会话中或转换为 JSON。**表单验证从未如此简单。**有关 FormRequest 验证的更多信息，请查看文档。

简单的控制器请求验证 ​

Laravel 5 基础控制器现在包含一个 ValidatesRequests trait。此 trait 提供一个简单的 validate 方法来验证传入请求。如果 FormRequests 对您的应用程序来说有点过多，请查看以下内容：

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

如果验证失败，将抛出异常，并自动将适当的 HTTP 响应发送回浏览器。验证错误甚至会被闪存到会话中！如果请求是 AJAX 请求，Laravel 甚至会负责将验证错误的 JSON 表示发送回您。

有关此新方法的更多信息，请查看文档。

新生成器 ​

为了补充新的默认应用程序结构，框架中添加了新的 Artisan 生成器命令。有关更多详细信息，请参阅 php artisan list。

配置缓存 ​

您现在可以使用 config:cache 命令将所有配置缓存到一个文件中。

Symfony VarDumper ​

流行的 dd 辅助函数已升级为使用惊人的 Symfony VarDumper。这提供了彩色编码的输出，甚至可以折叠数组。只需在项目中尝试以下内容：

php
dd([1, 2, 3]);

Laravel 4.2 ​

通过在 4.2 安装中运行 php artisan changes 命令，或通过在 Github 上查看更改文件，可以查看此版本的完整更改列表。这些说明仅涵盖此版本的主要增强和更改。

NOTE

在 4.2 发布周期中，许多小错误修复和增强已被合并到各种 Laravel 4.1 点版本中。因此，请务必查看 Laravel 4.1 的更改列表！

PHP 5.4 要求 ​

Laravel 4.2 需要 PHP 5.4 或更高版本。此升级的 PHP 要求允许我们使用新的 PHP 功能，如 traits，以为工具（如 Laravel Cashier）提供更具表现力的接口。PHP 5.4 还带来了显著的速度和性能改进。

Laravel Forge ​

Laravel Forge 是一个新的基于 Web 的应用程序，提供了一种简单的方法来在您选择的云上创建和管理 PHP 服务器，包括 Linode、DigitalOcean、Rackspace 和 Amazon EC2。支持自动化 Nginx 配置、SSH 密钥访问、Cron 作业自动化、通过 NewRelic 和 Papertrail 进行服务器监控、“Push To Deploy”、Laravel 队列工作者配置等，Forge 提供了启动所有 Laravel 应用程序的最简单和最实惠的方法。

默认的 Laravel 4.2 安装的 app/config/database.php 配置文件现在默认配置为 Forge 使用，允许更方便地将新应用程序部署到平台上。

有关 Laravel Forge 的更多信息，请访问官方 Forge 网站。

Laravel Homestead ​

Laravel Homestead 是一个官方的 Vagrant 环境，用于开发强大的 Laravel 和 PHP 应用程序。大多数盒子的配置需求在盒子打包分发之前就已处理完毕，使得盒子启动速度极快。Homestead 包括 Nginx 1.6、PHP 5.6、MySQL、Postgres、Redis、Memcached、Beanstalk、Node、Gulp、Grunt 和 Bower。Homestead 包括一个简单的 Homestead.yaml 配置文件，用于在单个盒子上管理多个 Laravel 应用程序。

默认的 Laravel 4.2 安装现在包括一个 app/config/local/database.php 配置文件，默认情况下配置为使用 Homestead 数据库，使 Laravel 的初始安装和配置更加方便。

官方文档也已更新，包括 Homestead 文档。

Laravel Cashier ​

Laravel Cashier 是一个简单、富有表现力的库，用于管理 Stripe 的订阅计费。随着 Laravel 4.2 的引入，我们将 Cashier 文档与主要的 Laravel 文档一起包含，尽管组件本身的安装仍然是可选的。此版本的 Cashier 带来了众多错误修复、多货币支持以及与最新 Stripe API 的兼容性。

守护进程队列工作者 ​

Artisan queue:work 命令现在支持 --daemon 选项，以守护进程模式启动工作者，这意味着工作者将继续处理作业，而不会重新启动框架。这显著减少了 CPU 使用率，但代价是稍微复杂的应用程序部署过程。

有关守护进程队列工作者的更多信息，请查看队列文档。

邮件 API 驱动 ​

Laravel 4.2 引入了新的 Mailgun 和 Mandrill API 驱动，用于 Mail 功能。对于许多应用程序，这提供了一种比 SMTP 选项更快、更可靠的发送电子邮件的方法。新驱动使用 Guzzle 4 HTTP 库。

软删除 Traits ​

通过 PHP 5.4 traits 引入了一种更清晰的“软删除”和其他“全局作用域”的架构。这种新架构允许更容易地构建类似的全局 traits，并在框架本身中实现更清晰的关注点分离。

有关新 SoftDeletingTrait 的更多信息，请查阅 Eloquent 文档。

方便的 Auth 和 Remindable Traits ​

默认的 Laravel 4.2 安装现在使用简单的 traits 来包含身份验证和密码提醒用户界面所需的属性。这为开箱即用的默认 User 模型文件提供了更清晰的结构。

"Simple Paginate" ​

查询和 Eloquent 构建器中添加了一个新的 simplePaginate 方法，允许在分页视图中使用简单的“下一页”和“上一页”链接时进行更高效的查询。

迁移确认 ​

在生产环境中，破坏性的迁移操作现在将要求确认。可以使用 --force 命令强制运行命令而无需任何提示。

Laravel 4.1 ​

完整更改列表 ​

通过在 4.1 安装中运行 php artisan changes 命令，或通过在 Github 上查看更改文件，可以查看此版本的完整更改列表。这些说明仅涵盖此版本的主要增强和更改。

新的 SSH 组件 ​

此版本引入了一个全新的 SSH 组件。此功能允许您轻松 SSH 到远程服务器并运行命令。要了解更多信息，请查阅 SSH 组件文档。

新的 php artisan tail 命令利用了新的 SSH 组件。有关更多信息，请查阅 tail 命令文档。

Boris 在 Tinker 中 ​

如果您的系统支持，php artisan tinker 命令现在使用 Boris REPL。必须安装 readline 和 pcntl PHP 扩展才能使用此功能。如果您没有这些扩展，将使用 4.0 中的 shell。

Eloquent 改进 ​

Eloquent 中添加了一个新的 hasManyThrough 关系。要了解如何使用它，请查阅 Eloquent 文档。

还引入了一个新的 whereHas 方法，允许基于关系约束检索模型。

数据库读/写连接 ​

整个数据库层，包括查询构建器和 Eloquent，现在可以自动处理单独的读/写连接。有关更多信息，请查阅文档。

队列优先级 ​

通过将逗号分隔的列表传递给 queue:listen 命令，现在支持队列优先级。

失败的队列作业处理 ​

队列功能现在包括在使用新的 --tries 开关在 queue:listen 上时自动处理失败的作业。有关处理失败作业的更多信息，请查阅队列文档。

缓存标签 ​

缓存“部分”已被“标签”取代。缓存标签允许您为缓存项分配多个“标签”，并刷新分配给单个标签的所有项。有关使用缓存标签的更多信息，请查阅缓存文档。

灵活的密码提醒 ​

密码提醒引擎已更改，以提供更大的开发者灵活性，用于验证密码、将状态消息闪存到会话等。有关使用增强的密码提醒引擎的更多信息，请查阅文档。

改进的路由引擎 ​

Laravel 4.1 具有完全重写的路由层。API 是相同的；然而，与 4.0 相比，注册路由的速度提高了 100%。整个引擎已大大简化，并且对 Symfony 路由的依赖已最小化到路由表达式的编译。

改进的会话引擎 ​

在此版本中，我们还引入了一个全新的会话引擎。与路由改进类似，新的会话层更精简、更快。我们不再使用 Symfony（因此也不再使用 PHP）的会话处理设施，而是使用一个更简单、更易于维护的自定义解决方案。

Doctrine DBAL ​

如果您在迁移中使用 renameColumn 函数，您需要将 doctrine/dbal 依赖项添加到 composer.json 文件中。此包不再默认包含在 Laravel 中。

版权所有 © 2024-2025 laravel.wiki