修改composer.json:
"laravel/framework": "5.5.*", "phpunit/phpunit": "~6.0"
scripts增加:
"post-autoload-dump": [ "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump", "@php artisan package:discover" ]
执行composer update -vvv
新特性1: 扩展包自动发现
为扩展包增加了一个自动发现功能。
以barryvdh/laravel-debugbar为例,先删除这个包。composer remove barryvdh/laravel-debugbar
先把APP里面的Barryvdh\Debugbar\ServiceProvider::class,去掉。
就删除成功了。
再重新安装:
我们看github上这个包最新版的
Installing barryvdh/laravel-debugbar (v3.1.0): Downloading (100%)
里面的包的composer.json有这么一个说明:
"extra": { "branch-alias": { "dev-master": "3.0-dev" }, "laravel": { "providers": [ "Barryvdh\\Debugbar\\ServiceProvider" ], "aliases": { "Debugbar": "Barryvdh\\Debugbar\\Facade" } } },
我们看到,在bootstrap/cache/packages.php里面已经写上了debugbar,并且我们在页面上也可以看到有debugbar的存在。但是我们并不需要在app.php里面增加debugbar的serviceProvider了。非常方便!!!
就是说,我们引入的包里面,只要有这个extra.laravel的说明,后面的providers和alias会自动增加到框架中去。
新特性2: api resources
这个特性的功能就是把资源直接作为api返回给前端,并且进行需要的包装。
这里的resource就是返回资源,我们可以创建这么一个返回资源,这个资源会被包装在data字段中,json,api返回。
比如创建一个PostCollection资源。代表文章集合。
php artisan make:resource PostCollection
我希望返回的api里面有两个字段:data和meta,data代表的就是文章集合,meta代表的是一些附属的元数据信息。
<?php namespace App\Http\Resources; use Illuminate\Http\Resources\Json\ResourceCollection; class PostCollection extends ResourceCollection { /** * Transform the resource collection into an array. * * @param \Illuminate\Http\Request * @return array */ public function toArray($request) { return parent::toArray($request); } public function with($request) { return [ 'meta' => [ 'site' => 'laravel55', ], ]; } }
在路由中:
Route::get('/api/posts', function () { return new \App\Http\Resources\PostCollection(\App\Post::all()); });
并且在\App\Post中重新定义toArray()
public function toArray() { return [ "id" => $this->id, "title" => $this->title, ]; }
那么这个时候就返回了:
有人说,其实laravel中在控制器中直接返回对象也就是调用它们的toArray方法,那么如果你把上式的路由修改为:
Route::get('/api/posts', function () { return new \App\Http\Resources\PostCollection(\App\Post::paginate(3)); });
你就感觉到增加这个”api resource”的方便性了:统一API返回结构,并且让你少写了很多代码。
特性3: command能自动注册
我们之前自定义的Command需要在Console\Commands\Kernel.php中写上每个Command:
class Kernel extends ConsoleKernel { /** * The Artisan commands provided by your application. * * @var array */ protected $commands = [ \App\Console\Commands\ESInit::class ];
现在,不用了,只修改commands函数:
protected function commands() { $this->load(__DIR__ . '/Commands'); require base_path('routes/console.php'); }
特性4:验证规则类
这个规则是为了我们的自定义验证规则。比如,我们的登录,需要邮箱后缀为gmail.com才能登录。那么这个时候我们就需要定义一个验证规则类:
php artisan make:rule ValidLoginEmail
我们在App\Rules文件夹下面看到ValidLoginEmail类:
class ValidLoginEmail implements Rule { /** * Create a new rule instance. * * @return void */ public function __construct() { // } /** * Determine if the validation rule passes. * * @param string $attribute * @param mixed $value * @return bool */ public function passes($attribute, $value) { $strs = explode("@", $value); if (count($strs) == 2 && $strs[1] == "gmail.com") { return true; } return false; } /** * Get the validation error message. * * @return string */ public function message() { return '邮箱必须是gmail结尾'; } }
然后再修改loginController的login()的验证部分:
$this->validate(request(),[ 'email' => ['required', new ValidLoginEmail(), 'email'], 'password' => 'required|min:5|max:10', 'is_remember' => 'integer' ]);
效果:
新特性5: request增加了validate方法
还是login方法,我们也可以这样写:
public function login(Request $request) { // 验证 $request->validate([ 'email' => ['required', new ValidLoginEmail(), 'email'], 'password' => 'required|min:5|max:10', 'is_remember' => 'integer' ]);
不再需要使用
$this->validate(request(),[
这样做的好处是更语义化了:验证请求符合下列规则…
新特性6: 自定义Exception增加了render和report方法
在以前,我们自定义一个Exception类,要想这个异常单独处理,就需要在Handler.php里面的render方法这么写:
public function render($request, Exception $exception) { if ($exception instanceof \App\Exceptions\ForbiddenException) { return response()->view("exceptions/forbidden"); } return parent::render($request, $exception); }
这样自定义异常定义多了,这个函数就非常冗余。
现在的方法就是,在自定义异常里面定义一下render方法就行
<?php namespace App\Exceptions; class ForbiddenException extends \Exception { /** * Report the exception. * * @return void */ public function report() { // } /** * Report the exception. * * @param \Illuminate\Http\Request * @return void */ public function render($request) { return response()->view("exceptions/forbidden"); } }
新特性7: 增加了Route::view方法
如果你这个路由什么逻辑都没有,只是渲染一个模版,那么就很适合使用这个方法。比如创建文章页面:
原先:
Route::get('/posts/create', '\App\Http\Controllers\PostController@create'); // 创建页面 public function create() { return view("post/create"); }
现在:
// 创建文章
Route::view('/posts/create', 'post/create');