[+]文章目录

升级指南

更新到5.1.0

预计更新时间:小于1小时

更新 bootstrap/autoload.php

更新 bootstrap/autoload.php 中的变量 $compilePath:

$compiledPath = __DIR__.'/cache/compiled.php';

创建 bootstrap/cache 目录

在 bootstrap 目录中,创建 cache 目录,在该目录中创建一个 .gitignore 文件,编辑文件内容如下:

*!.gitignore

该目录应该是可写的,用来存储临时优化文件如 compiled.php,routes.php,config.php 以及 service.json

新增 BroadcastServiceProvider

在配置文件 config/app.php 中,添加 Illuminate\Broadcasting\BroadcastServiceProvider 到 providers 数组。

认证

如果你在使用 Laravel 自带的 AuthenticatesAndRegistersUsers 的 AuthController,则需要对新用户的验证和创建做一些代码改动:

首先,你不再需要传递 Guard 和 Register 实例到构造函数,你可以从控制器的构造器中完全移除这些以依赖。

然后,Laravel 5.0 中使用的 App\Services\Registrar 不再被需要,你可以直接简单拷贝粘贴其中的 validator 方法和 create 方法到 AuthController 中,这两个方法中的代码不需要做任何改动。不要忘记确认 Validator 和 User 在 AuthController 中是否已经被导入。

PasswordController 不再需要在构造函数中声明任何依赖,可以移除5.0中要求的两个依赖。

验证

如果你重写了 Controller 类中的 formatValidationErrors 方法,需要将类型提示由 Illuminate\Validation\Validator 改为 Illuminate\Contracts\Validation\Validator。

Eloquent

create 方法

Eloquent 的 create 方法现在可以不传入任何参数进行调用,如果你在模型中要重写 create 方法,将 $attributes 参数的默认值改为数组:

public static function create(array $attributes = []){
    // Your custom implementation
}

find 方法

如果你要在自己的模型中重写 find 方法并在其中调用 parent::find(),应该改由调用 Eloquent 查询构建器的 find 方法:

public static function find($id, $columns = ['*']){
    $model = static::query()->find($id, $columns);

    // ...

    return $model;
}

lists 方法

lists 方法现在返回一个 Collection 实例而不是包含 Eloquent 查询结果的数组,如果你想将 Collection 转化为数组,使用 all 方法:

User::lists('id')->all();

注意:Query Builder 的 lists 返回的仍然是数组。

日期格式化

以前,模型中的 Eloquent 日期字段存储格式可以通过重写 getDateFormat 方法来修改,现在依然可以这么做;但是为了更加方便可以在模型中简单通过指定 $dateFormat 属性来替代重写方法。

在序列化模型到数组或 JSON 时日期格式也被应用到,当从 Laravel 5.0 迁移到5.1时,这将会改变 JSON 序列化的日期字段的格式。想要在序列化模型中设置指定的日期格式,你可以在模型中重写 serializeDate(DateTime $date)方法,这样就可以在不改变字段存储格式的情况下对格式化序列化的 Eloquent 日期字段有着更加细粒度的控制。

Collection 类

sortBy 方法

sortBy 方法现在返回一个新的 collection 实例而不是改变已有的 collection:

$collection = $collection->sortBy('name');

groupBy 方法

groupBy 方法现在为每个父级 Collection 中的 item 返回 Collection 实例,如果你想要将这些 items 转化为数组,可以通过 map 方法实现:

$collection->groupBy('type')->map(function($item){
    return $item->all();
});

lists 方法

lists 方法现在返回一个 Collection 实例而不是数组,如果你想要将 Collection 转化数组,使用 all 方法:

$collection->lists('id')->all();

命令&处理器

app/Commands 目录现在被重命名为 app/Jobs,但是并不需要将你的命令移动到新位置,你可以继续使用 make:command 和 handler:command Artisan 命令生成自己的类。

同样的,app/Handlers 目录被合并到 app/Listeners 目录下,你也不必将已经存在的命令和事件处理器进行移动和重命名,你可以继续使用 handler:event 命令生成事件处理器。

通过提供对 Laravel 5.0 目录结构的向后兼容,你可以无缝升级应用到 Laravel 5.1 然后慢慢升级你的事件和命令到新的位置——在一个对你或你的团队合适的时间。

Blade

createMatcher,createOpenMatcher 和 createPlainMatcher 方法已经从 Blade 编译器中移除,可以使用新的 directive 方法来为5.1版的 Blade 创建自定义的指令。查阅扩展 Blade 文档了解详情。

测试

在 tests/TestCase.php 文件中新增 protected 属性 $baseUrl:

protected $baseUrl = 'http://localhost';

翻译文件

用于为 vendor 包发布语言文件的默认目录做了移动,所有 vendor 包语言文件从 resources/lang/packages/{locale}/{namespace} 移动到了 resources/lang/vendor/{namespace}/{locale} 目录。例如,Acme/Anvil 包的 acme/anvil::foo 英语语言文件将会从 resources/lang/packages/en/acme/anvil/foo.php 移动到 resources/lang/vendor/acme/anvil/en/foo.php。

Amazon Web Services SDK

如果你正在使用 AWS SQS 队列驱动或者 AWS SES 电子邮件驱动,需要升级 AWS PHP SDK 到3.0版本。

如果你正在使用 Amazon S3 文件系统驱动,需要通过 Composer 升级相应的文件系统包:

  • Amazon S3: league/flysystem-aws-s3-v3 ~1.0

废弃

以下 Laravel 特性已经被废弃并且会在2015年12月份的 Laravel 5.2 中被完全移除:

  • 中间件中的路由过滤器
  • Illuminate\Contracts\Routing\Middleware,中间件中不再需要任何 contract,Illuminate\Contracts\Routing\TerminableMiddleware 被废弃,在中间件中定义一个 terminate 方法替代实现该接口。
  • Illuminate\Contracts\Queue\ShouldBeQueued 被废弃,使用 Illuminate\Contracts\Queue\ShouldQueue
  • Iron.io “推入队列” 被废弃, 使用 Iron.io 队列和队列监听器.
  • Illuminate\Foundation\Bus\DispatchesCommands trait 被废弃并被重命名为 Illuminate\Foundation\Bus\DispatchesJobs.
  • Illuminate\Container\BindingResolutionException 被移动到 Illuminate\Contracts\Container\BindingResolutionException.
  • 服务容器的 bindShared 方法被废弃,使用 singleton 方法。
  • Eloquent 和 query builder 的 pluck 方法被废弃并重命名为 value.
  • Collection 的 fetch 方法被废弃,使用 pluck 方法.
  • array_fetch 帮助函数被废弃, 使用 array_pluck

« 前一篇