前言:
最近在学习 laravel 框架,学习的版本是 7.15.0 ,记录一下学习过程中遇到的问题和难点以及一些总结。
中间件定义
中间件主要用于拦截或者过滤 http 请求,并进行必要的业务处理。
要创建一个新的中间件,可以通过 Artisan 命令 make:middleware:
php artisan make:middleware CheckToken
来创建,创建的中间件位置在 app/Http/Middleware/ 文件夹下
中间件的结构
<?php
namespace App\Http\Middleware;
use Closure;
class CheckToken
{
/**
* Handle an incoming request.
*
* @param \Illuminate\Http\Request $request
* @param \Closure $next
* @return mixed
*/
public function handle($request, Closure $next)
{
return $next($request);
}
}
中间件的入口执行方法必须是 handle 方法,而且第一个参数是 Request 对象,第二个参数是一个闭包,在一些情况下允许有第三个参数。
请求之前中间件
<?php
namespace App\Http\Middleware;
use Closure;
class BeforeMiddleware
{
public function handle($request, Closure $next)
{
// 执行动作
return $next($request);
}
}
请求之后中间件
<?php
namespace App\Http\Middleware;
use Closure;
class AfterMiddleware
{
public function handle($request, Closure $next)
{
$response = $next($request);
// 执行动作
return $response;
}
}
注册中间件
中间件分三类,分别是全局中间件、中间件组和指定路由中间件。
全局中间件
如果你想要定义的中间件在每一个 HTTP 请求时都被执行,只需要将相应的中间件类添加到 app/Http/Kernel.php 的数组属性 $middleware 中即可:
加入需要作为全局中间件。
注意:但除非真的需要,否则我们一般不会把业务级别的中间件放到全局中间件中。
指定路由中间件
如果你想要分配中间件到指定路由,首先应该在 app/Http/Kernel.php 文件中分配给该中间件一个 key,默认情况下,该类的 $routeMiddleware 属性包含了 Laravel 自带的中间件,要添加你自己的中间件,只需要将其追加到后面并为其分配一个 key,例如:
中间件在 HTTP Kernel 中被定义后,可以使用 middleware 方法将其分配到路由:
Route::get('/', function () {
//
})->middleware('token');
接口地址中需要加上 token 参数才可以访问,http://127.0.0.1:86/user?token=a090eac9d0387ad01ca46e00cc390869 时才能正常访问。
中间件组
有时候你可能想要通过指定一个键名的方式将相关中间件分到同一个组里面,这样可以更方便地将其分配到路由中,这可以通过使用 HTTP Kernel 提供的 $middlewareGroups 属性实现。
Laravel 自带了开箱即用的 web 和 api 两个中间件组,分别包含可以应用到 Web 和 API 路由的通用中间件:
web这个键值,它对应为一个数组,该数组有多个中间件组成,需要声明路由的时候,如下调用就可以了。
Route::group(['middleware' => 'web'],function($route){
$route->get('hello/world',function(){});
$route->get('hello/php',function(){});
// 这样在访问这个这些路由的时候,就会执行中间件组 web 所对应的中间件!
});
$middleware 全局中间件,要对所有的请求要做一些处理的时候,就适合定义在该属性内。
$middlewareGroups 中间件组,项目有 api 请求和 web 的请求的时候,就要把两种类型的请求中间件分离开来,这时候就需要中间件组。
$routeMiddleware 路由中间件,有些个别的请求,需要执行特别的中间件时,就适合定义在这属性里面。