Laravel 5.0 中文文档

简体中文

English

简体中文

English

主题

发布说明 ​

支持政策 ​

安全修复始终应用于 Laravel 的前一个主要版本。目前，所有安全修复和补丁将应用于 Laravel 5.x 和 Laravel 4.x。

在可行的情况下，安全修复也将应用于更旧版本的框架，例如 Laravel 3.x。

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
class PodcastWasPurchased {

	public $podcast;

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

}

事件可以像往常一样调度：

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

	/**
	 * 创建一个新的命令实例。
	 *
	 * @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 上查看更改文件来查看此版本的完整更改列表。这些说明仅涵盖了此版本的主要增强和更改。

lightbulb

在 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 文档。

方便的认证和提醒 Traits ​

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

"简单分页" ​

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

迁移确认 ​

在生产环境中，破坏性的迁移操作现在将要求确认。可以使用 --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 命令来支持队列优先级。

失败的队列作业处理 ​

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

缓存标签 ​

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

灵活的密码提醒 ​

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

改进的路由引擎 ​

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

改进的会话引擎 ​

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

Doctrine DBAL ​

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

版权所有 © 2024-2025 laravel.wiki