# 升级指南
- [从 5.5 升级至 5.6.0](#upgrade-5.6.0)
## 从 5.5 升级至 5.6.0
#### 预计升级耗时:10 - 30 分钟
> {note} 我们尽量记录每一个可能的破坏性变化。但因为其中一些不兼容变更只存在于框架很不起眼的地方,事实上只有一小部分可能会影响到你的应用程序。
### PHP
Laravel 5.6 要求 PHP 7.1.3 或更高。
### 更新依赖
在 `composer.json` 文件中将 `laravel/framework` 更新为 `5.6.*` 。此外,你还应将 `fideloper/proxy` 依赖关系更新至 `~4.0`。
此外,如果你使用下面的官方 Laravel 包,你应将升级至最新版本:
- Dusk (升级至 `~3.0`)
- Passport (升级至 `~5.0`)
- Scout (升级至 `~4.0`)
当然,不要忘记检查你应用程序的第三方包能否支持 Laravel 5.6。
#### Symfony 4
所有 Laravel 底层使用到的 Symfony 组件都已经更新至 `~4.0` 发布版本。如果你在应用中直接的与 Symfony 组件进行了交互,你应该浏览下[ Symfony 变更日志](https://github.com/symfony/symfony/blob/master/UPGRADE-4.0.md)。
#### PHPUnit
你必须将你应用中依赖的 `phpunit/phpunit` 更新至 `~7.0` 版本。
### Arrays
#### `Arr::wrap` 方法
传递给 `Arr::wrap` 方法的 `null` 现在将返回一个空数组。
### Artisan
#### `optimize` 命令
先前被弃用的 `optimize` Artisan 命令已经被移除。 随着 `php` 对自身和对操作码缓存的改进, `optimize` 命令已经无法再提供任何性能上的提升。因此你可以将 `php artisan optimize` 从你的 `composer.json` 文件的 `scripts` 选项中移除。
### Blade
#### HTML 实体编码
在以前的 Laravel 版本中,Blade(和 `e` 全局辅助函数)不会对 HTML 实体进行双重编码。 这不是底层 `htmlspecialchars` 函数的默认行为,在呈现内容或将内联 JSON 内容传递给 JavaScript 框架时可能会导致意外行为。
在 Laravel 5.6 中,Blade 和 `e` 全局辅助函数默认会对特殊字符进行双重编码。 使得这些功能与底层的 `htmlspecialchars` PHP 函数的默认行为保持一致。 如果你想保持以前防止重复编码的行为,你可以使用 `Blade::withoutDoubleEncoding` 方法:
### Logging
#### 新的配置文件
所有的日志配置现在都存放在它自己的 `config / logging.php` 配置文件中,你应该在你自己的应用程序中放置一个[默认配置文件](https://github.com/laravel/laravel/blob/develop/config/logging.php)的副本,并根据你的应用程序的需要进行调整修改。
`log` 和 `log_level` 配置选项可以在 `config / app.php` 配置文件中删除。
#### `configureMonologUsing` 方法
如果你使用 `configureMonologUsing` 方法为应用程序自定义 Monolog 实例,你现在应该创建一个 `custom` 日志通道。有关如何创建自定义频道的更多信息,请查看 [full logging documentation](/docs/laravel/5.6/logging#creating-custom-channels)。
#### 日志类 `Writer`
`Illuminate\Log\Writer` 类已经被重命名为 `Illuminate\Log\Logger` 。 如果你明确地将此类作为你的应用中的类之一的依赖项,你应该将类引用更新为新名称。 或者, 二者选一地,你应该强烈考虑用标准化的 `Psr\Log\LoggerInterface` 接口来代替。
#### `Illuminate\Contracts\Logging\Log` 接口
因为与 `Psr\Log\LoggerInterface` 完全重复, 这个接口已经被移除。你应该用 `Psr\Log\LoggerInterface` 接口来代替。
### 邮件
#### `withSwiftMessage` 回调
在 Laravel 之前的版本中,使用 `withSwiftMessage` 方法注册的 Swift 消息定制化回调被称为 _after_ 内容已经被编码并且添加到消息中。现在这些被称为 _before_ 内容回调被添加,它们允许你定制这些编码或者是其他需要的消息选项。
### 分页
#### Bootstrap 4
现在分页链接被分页器默认采用 Bootstrap 4 生成。使分页器去生成 Bootstrap 3 的链接,可以在你的 `AppServiceProvider` 文件的 `boot` 方法中使用 `Paginator::useBootstrapThree` 方法:
validate()` 方法冲突, `ValidatesWhenResolved` 接口 / trait 的 `validate` 方法已被改名为 `validateResolved` 。
### 其它
我们同样鼓励你去翻阅 `laravel/laravel` [GitHub 仓库](https://github.com/laravel/laravel) 中的修改记录。 虽然很多修改不是必需的,但你可能希望这些文件与你的应用程序同步。本升级指南中只介绍了部分修改,而其它像修改配置文件或注释等修改则不会介绍。你可以使用 [GitHub 比较工具](https://github.com/laravel/laravel/compare/5.5...5.6) 很轻松的查看这些修改并选择对你重要的更新。