Laravel5.6中文文档（兼容5.5）.zip

共1个文件

pdf：1个

版权申诉

laravel

131 浏览量 2022-04-21 21:08:12 上传评论收藏 11.27MB ZIP 举报

资源推荐

资源详情

资源评论

收起资源包目录

Laravel 5.6 中文文档（兼容5.5）.zip （1个子文件）

Laravel 5.6 中文文档（兼容5.5）

laravel-doc-5_6.pdf 14.56MB

本文档由 Laravel 学院提供

Laravel 学院致力于提供优质 Laravel 中文学习资源：http://laravelacademy.org

一、序言

新版特性

Laravel 5.6 在 Laravel 5.5 的基础上继续进行优化，包括日志系统、单机任务调度、模型序列化优化、动态频率限制、广播频道类、API 资源控制器

生成、Eloquent 日期格式化优化、Blade 组件别名、Argon2 密码哈希支持、引入 Collision 扩展包等等等等。此外，所有的前端脚手架代码都已升

级到 Bootstrap 4，Laravel 底层使用的 Symfony 组件都已升级到 Symfony ~4.0 版本。

Laravel 5.6 版本的发布恰逢 Spark 6.0 的发布，所以这也是自 Laravel Spark 发布以来第一次重大版本升级。Spark 6.0 为 Stripe 和 Braintree 引入

了按座定价功能，以及本地化、Bootstrap 4、增强 UI 和 Stripe Elements 支持。

注：本文档只是概述了框架大部分引人注目的重要升级，要了解详细升级日志可以查看 GitHub 上到 change logs。

日志优化

Laravel 5.6 带来了日志系统的重大升级，所有日志配置都存放在新的 config/logging.php 配置文件，你现在可以轻松构建发送日志消息到多个处

理器的日志”堆栈”。例如，你可以发送所有 debug 级别消息到系统日志同时发送 error 级别消息到 Slack 以便团队成员可以快速响应：

'channels' => [

'stack' => [

'driver' => 'stack',

'channels' => ['syslog', 'slack'],

此外，现在可以使用日志系统的新”tap”功能很轻松地自定义已存在的日志频道。想要了解更多细节，请查看完整日志文档。

单机任务调度

注：要使用这个新特性，必须使用 memcached 或 redis 缓存驱动作为应用默认缓存驱动。此外，所有服务器必须和同一个中心缓存服务器进行通

信。

如果你的应用运行在多个服务器上，现在可以限定只在一台机器上运行调度任务。例如，假设你有一个在每周五晚上生成新报告的调度任务，如果任

务调度器运行在三个服务器上，这个调度任务就会在三台机器上运行并生成同样的报告三次，这样很不优雅，甚至很糟糕！

要指定任务只在一台机器上运行，可以在定义调度任务时使用 onOneServer 方法，第一台获取到任务的机器会给这个任务上一把原子级别的锁来阻

止其他服务器同时运行同一个任务：

$schedule->command('report:generate')

->fridays()

->at('17:00')

->onOneServer();

动态频率限制

当我们在之前版本的路由群组中指定了频率限制后，必须要硬编码最大请求次数：

本文档由 Laravel 学院提供

Laravel 学院致力于提供优质 Laravel 中文学习资源：http://laravelacademy.org

Route::middleware('auth:api', 'throttle:60,1')->group(function () {

Route::get('/user', function () {

});

在 Laravel 5.6 中，你可以基于认证用户模型属性指定一个动态的最大请求次数，如果 User 模型包含 rate_limit 属性，可以将属性名传递

给 throttle 中间件，以便用于计算最大请求次数计数：

Route::middleware('auth:api', 'throttle:rate_limit,1')->group(function () {

Route::get('/user', function () {

});

广播频道类

如果你的应用消费多个不同的频道，routes/channels.php 文件可能会变得很臃肿，所以，作为使用闭包来授权频道的替代方案，你现在可以使用

频道类。要生成一个频道类，可以使用 Artisan 命令 make:channel。该命令会将新生成的频道类存放到 app/Broadcasting 目录下：

php artisan make:channel OrderChannel

接下来，在 routes/channels.php 文件中注册这个频道类：

use App\Broadcasting\OrderChannel;

Broadcast::channel('order.{order}', OrderChannel::class);

最后，可以将频道的授权逻辑放到频道类的 join 方法。join 方法中的代码等同于之前位于频道授权闭包中的处理逻辑。当然，你还可以使用频道模

型绑定：

<?php

namespace App\Broadcasting;

use App\User;

use App\Order;

class OrderChannel

{

/**

* Create a new channel instance.

* @return void

public function __construct()

{

}

/**

* Authenticate the user's access to the channel.

* @param \App\User $user

* @param \App\Order $order

* @return array|bool

public function join(User $user, Order $order)

{

return $user->id === $order->user_id;

}

API 控制器生成

声明被 API 消费的资源控制器时，通常你会排除输出 HTML 模板的路由，例如 create 和 edit，要生成不包含这些方法的资源控制器，可以在使

用 Artisan 命令执行 make:controller 时使用 --api 开关：

php artisan make:controller API/PhotoController --api

模型序列化优化

在之前版本的 Laravel 中，队列中的模型在反序列化后不会带有完整的已加载关联关系。在 Laravel 5.6 中，模型上已加载的关联关系在队列任务被

处理时会自动进行重新加载。

本文档由 Laravel 学院提供

Laravel 学院致力于提供优质 Laravel 中文学习资源：http://laravelacademy.org

Eloquent 日期转化

现在你可以单独自定义 Eloquent 日期字段转化格式了，开始之前，需要在转化声明中指定目标日期格式。指定好之后，该格式就会在模型序列化为

数组/JSON 时使用：

protected $casts = [

'birthday' => 'date:Y-m-d',

'joined_at' => 'datetime:Y-m-d H:00',

];

Blade 组件别名

如果你的 Blade 组件存放在子目录中，现在起可以为它们起个别名以便使用。例如，假设一个 Blade 组件存放

在 resources/views/components/alert.blade.php，你可以使用 component 方法将这个组件名从 components.alert 改为别名 alert：

Blade::component('components.alert', 'alert');

组件起了别名之后，就可以使用别名来渲染：

@component('alert')

You are not allowed to access this resource!

@endcomponent

或者，如果组件没有额外插槽，可以使用组件别名作为 Blade 指令：

@alert

You are not allowed to access this resource!

@endalert

Argon2 密码哈希

如果你在构建一个基于 PHP 7.2.0+ 的应用，Laravel 现在可以支持通过 Argon2 算法进行密码哈希，默认的应用哈希驱动通过新增

的 config/hashing.php 配置文件来控制。

UUID 方法

Laravel 5.6 引入了两个新的方法来生成 UUID：Str::uuid 和 Str::orderedUuid，orderedUuid 方法会生成一个时间戳最靠前的 UUID，通过诸如

MySQL 的数据库来索引，更简单，也更高效。两个方法都会返回 Ramsey\Uuid\Uuid 对象：

use Illuminate\Support\Str;

return (string) Str::uuid();

return (string) Str::orderedUuid();

Collision

默认的 laravel/laravel 应用现在为 Collision 包含了一个 dev Composer 依赖，这个扩展包在通过命令行与 Laravel 应用交互时提供了美观的错误

报告：

本文档由 Laravel 学院提供

Laravel 学院致力于提供优质 Laravel 中文学习资源：http://laravelacademy.org

Bootstrap 4

所有前端脚手架例如用户登录认证模板和 Vue 示例组件都已经升级到 Bootstrap 4。默认情况下，生成的分页链接现在也已升级到 Bootstrap 4。

升级指南

预计升级时间：10-30 分钟

PHP

Laravel 5.6 需要 PHP 7.1.3 或更高版本。

更新依赖

在 composer.json 中更新 laravel/framework 依赖到 5.6.*，更新 fideloper/proxy 依赖到 ~4.0。

此外，如果你使用下以下官方扩展包，也要升级它们到最新版本：

 Dusk (升级到 ~3.0)

 Passport (升级到 ~5.0)

 Scout (升级到 ~4.0)

当然，不要忘了检查应用所使用的第三方扩展包是否支持 Laravel 5.6，如果需要升级的话也要更新。

Symfony 4

Laravel 底层使用的所有 Symfony 组件都已经升级到 Symfony ~4.0 版本。如果你在应用代码中使用了 Symfony 组件，需要查看 Symfony 更新日

志以确认是否需要修改代码。

PHPUnit

需要更新应用的 phpunit/phpunit 依赖到 ~7.0。

数组

Arr::wrap 方法

在 Laravel 5.6 中，传递 null 到 Arr::wrap 方法将会返回空数组。

Artisan

optimize 命令

之前版本中废弃的 optimize 命令已经被彻底移除。由于 PHP 自身的性能优化，optimize 命令已经不能给应用提供显著的性能提升，所以，你需

要从 composer.json 文件的 scripts 部分移除 php artisan optimize。

Blade

本文档由 Laravel 学院提供

Laravel 学院致力于提供优质 Laravel 中文学习资源：http://laravelacademy.org

HTML 实体编码

在之前版本的 Laravel 中，Blade 不会对 HTML 实体进行双重编码。这并不是底层 htmlspecialchars 函数的默认行为，而且会在渲染内容或传递内

联 JSON 内容到 JavaScript 框架时导致预期之外的结果。

在 Laravel 5.6 中，Blade 以及辅助函数 e 默认会对特殊字符进行双重编码，从而与 PHP 底层 htmlspecialchars 函数的默认行为保持一致。如果

你想要维持不进行双重编码的旧状，可以使用 Blade::withoutDoubleEncoding 方法：

<?php

namespace App\Providers;

use Illuminate\Support\Facades\Blade;

use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider

{

/**

* Bootstrap any application services.

* @return void

public function boot()

{

Blade::withoutDoubleEncoding();

}

缓存

频率限制器 tooManyAttempts 方法

该方法签名中未使用的 $decayMinutes 参数被移除。如果你通过自己的实现重写了该方法，也要从方法签名中移除该参数。

数据库

Morph 列的索引顺序

为了获得更好的性能，迁移方法 morphs 构建的列索引顺序倒过来了，如果你在某个迁移中使用了 morphs 方法，尝试运行该迁移的 down 方法时会报

错。如果应用还在开发中，可以使用 migrate:fresh 命令重构数据库结构；如果应用已经上线，需要显式传递索引名称到 morphs 方法。

MigrationRepositoryInterface 新增方法

MigrationRepositoryInterface 中新增了一个 getMigrationsBatches 方法。如果非常不巧你正在自定义该类的实现，需要添加这个方法的实

现。你可以以框架的默认实现作为示例。

Eloquent

getDateFormat 方法

getDateFormat 方法的可见性从 protected 调整为 public。

哈希

新配置文件

所有哈希配置现在位于独立的 config/hashing.php 配置文件。你可以拷贝一份默认配置文件到你的应用。大多数情况下，我们都会将 bcrypt 驱动

作为默认驱动。不过，也支持 argon。

辅助函数

在之前版本的 Laravel 中，Blade （以及辅助函数 e）不会对 HTML 实体进行双重编码。这并不是底层 htmlspecialchars 函数的默认行为，而且会

在渲染内容或传递内联 JSON 内容到 JavaScript 框架时导致预期之外的结果。

在 Laravel 5.6 中，Blade 以及辅助函数 e 默认会对特殊字符进行双重编码，从而与 PHP 底层 htmlspecialchars 函数的默认行为保持一致。如果

你想要维持不进行双重编码的旧状，可以传递 false 作为第二个参数到 e 函数：

<?php echo e($string, false); ?>

日志

新配置文件

所有的日志配置现在都存放在独立的 config/logging.php 配置文件。你可以拷贝一份默认的配置文件到你的应用然后基于应用需要进行设置。

log 和 log_level 配置项都可以从配置文件 config/app.php 里移除了。

configureMonologUsing 方法

如果你在使用 configureMonologUsing 方法为应用自定义 Monolog 实例，现在需要创建一个 custom 日志频道。更多关于如何创建自定义频道的

信息，可以查看完整的日志文档。

日志 Writer 类

评论收藏

内容反馈

版权申诉

reg183

粉丝: 1840
资源: 1万+

Laravel 5.6 中文文档（兼容5.5）.zip

Laravel 5.6 中文文档

laravel5.6版本下载

php5.6版本下载

laravel5.6流程

EhLib.v5.6.215.Full.Source

EhLib 5.6 Build 5.6.215 Full source

EhLib5.6. for delphi XE2

EhLib 5.2.84Full.Source _EhDbGrid

Laravel 5.6 一键安装包

Laravel 5.5 中文文档

rest-5.5.1.jar中文-英文对照文档.zip

Android代码-Laravel 5.5 中文文档

reindex-client-5.5.1.jar中文-英文对照文档.zip

dozer-5.5.1.jar中文-英文对照文档.zip

cryptopp.dll 已编译的多个版本(5.6.1.0, 5.5.2.0, 5.3.0.0, 5.2.3.0, 5.2.0.0, 5.0.4.0)

wordpress-5.6-zh_CN.zip

laravel5.6官方文档（word版）

net-snmp-5.6.1.1-1.x86.exe

Laravel 5.5 一键安装包

jna-5.6.0.jar中文文档.zip

spring-security-config-5.6.1.jar中文-英文对照文档.zip

jna-5.6.0.jar中文-英文对照文档.zip

percolator-client-5.5.1.jar中文-英文对照文档.zip

junit-jupiter-engine-5.6.2.jar中文-英文对照文档.zip

RTL88x2BUv5.6.1.6_35492.zip

MySQL-5.6.48-1.el7.x86_64.rpm-bundle.tar.zip

Angular 6 Starter with Laravel 5.6 API Service.zip

MySQL-server-5.6.48-1.el7.x86_64.rpm

winrar5.6中文没广告原版.zip

最新资源