laravel 中间件——迹忆客-ag捕鱼王app官网

注册中间件

全局中间件

如果希望中间件在任何http请求路由之前执行，而不是针对某一个路由或者一组路由。可以在app/http/kernel.php类的$middleware属性中列出中间件类。

给路由分配中间件

如果要将中间件分配给特定的路由，则应首先在应用程序的app/http/kernel.php文件中为中间件指定一个键名。 默认情况下，该类的$routemiddleware数组包含laravel自带的中间件。 我们可以将自己的中间件添加到此列表中，并为其分配一个键名：

// within app\http\kernel class...
protected $routemiddleware = [
    'auth' => \app\http\middleware\authenticate::class,
    'auth.basic' => \illuminate\auth\middleware\authenticatewithbasicauth::class,
    'bindings' => \illuminate\routing\middleware\substitutebindings::class,
    'cache.headers' => \illuminate\http\middleware\setcacheheaders::class,
    'can' => \illuminate\auth\middleware\authorize::class,
    'guest' => \app\http\middleware\redirectifauthenticated::class,
    'signed' => \illuminate\routing\middleware\validatesignature::class,
    'throttle' => \illuminate\routing\middleware\throttlerequests::class,
    'verified' => \illuminate\auth\middleware\ensureemailisverified::class,
];

我们的中间件在http kernel中定义完成之后，我们就可以使用middleare方法给某个路由分配该中间件了。

route::get('/profile', function () {
    //
})->middleware('auth');

同样，我们还可以给路由一次性分配多个中间件，这就需要给middleware方法传一个数组

route::get('/', function () {
    //
})->middleware(['first', 'second']);

中间件的执行顺序，是按照数组中的先后顺序执行的

除了使用在http kernel中指定的键名为路由分配中间件之外，还可以使用完整的中间件的类给路由分配中间件：

use app\http\middleware\ensuretokenisvalid;
route::get('/profile', function () {
    //
})->middleware(ensuretokenisvalid::class);

将中间件分配给一组路由时，有时可能该组中的某一个路由并不需要该中间件，那我们可以使用withoutmiddleware方法完成此操作：

use app\http\middleware\ensuretokenisvalid;
route::middleware([ensuretokenisvalid::class])->group(function () {
    route::get('/', function () {
        //
    });
    route::get('/profile', function () {
        //
    })->withoutmiddleware([ensuretokenisvalid::class]);
});

withoutmiddleware 方法只是对使用middleware方法指定的中间件有效，对于app/http/kernel.php类的$middleware属性中列出的全局中间件是不起作用的。

中间件组

有时，我们可能希望将多个中间件归位一个组，给这个组分配一个键名，以使其更易于分配给路由。 可以使用http内核的$middlewaregroups属性来完成此操作。

laravel附带了web和api中间件组，其中包含我们可能要应用于web和api路由的常见中间件。 请记住，这些中间件组由应用程序的app\providers\routeserviceprovider自动应用到相应的web和api路由文件中的路由：

/**
 * the application's route middleware groups.
 *
 * @var array
 */
protected $middlewaregroups = [
    'web' => [
        \app\http\middleware\encryptcookies::class,
        \illuminate\cookie\middleware\addqueuedcookiestoresponse::class,
        \illuminate\session\middleware\startsession::class,
        // \illuminate\session\middleware\authenticatesession::class,
        \illuminate\view\middleware\shareerrorsfromsession::class,
        \app\http\middleware\verifycsrftoken::class,
        \illuminate\routing\middleware\substitutebindings::class,
    ],
    'api' => [
        'throttle:api',
        \illuminate\routing\middleware\substitutebindings::class,
    ],
];

将中间件组分配给路由或者控制器的方法于分配单个中间件的方法是一样的。中间件组的方式使得给路由分配多个中间件变得非常方便：

route::get('/', function () {
    //
})->middleware('web');
route::middleware(['web'])->group(function () {
    //
});

中间件排序

这种情况很少，但是也会遇到。我们可能需要中间件以特定的顺序执行，但是当它们被分配给路由时却无法控制它们的顺序。 在这种情况下，可以使用app/http/kernel.php文件的$middlewarepriority属性指定中间件优先级。 默认情况下，http kernel 中可能不存在此属性。 如果不存在，则可以复制下面的代码，这是默认的顺序：

/**
 * the priority-sorted list of middleware.
 *
 * this forces non-global middleware to always be in the given order.
 *
 * @var array
 */
protected $middlewarepriority = [
    \illuminate\cookie\middleware\encryptcookies::class,
    \illuminate\session\middleware\startsession::class,
    \illuminate\view\middleware\shareerrorsfromsession::class,
    \illuminate\contracts\auth\middleware\authenticatesrequests::class,
    \illuminate\routing\middleware\throttlerequests::class,
    \illuminate\session\middleware\authenticatesession::class,
    \illuminate\routing\middleware\substitutebindings::class,
    \illuminate\auth\middleware\authorize::class,
];

中间件参数

中间件也可以接收其他参数。 例如，如果应用程序需要在执行给定操作之前验证经过身份验证的用户是否具有给定的“角色”，则可以创建一个secureuserhasrole中间件，该中间件接收角色名称作为附加参数。

附加的中间件参数将在$next执行时之后传递给中间件：

user()->hasrole($role)) {
            // redirect...
        }
        return $next($request);
    }
}

在定义路由时，可以用冒号: 分隔中间件名称和参数来指定中间件参数。 多个参数应以逗号分隔：

route::put('/post/{id}', function ($id) {
    //
})->middleware('role:editor');

终止中间件

有时，在将http响应发送到浏览器之后，中间件可能需要做一些工作。 如果在中间件上定义了终止方法，并且web服务器正在使用fastcgi，则将响应发送到浏览器后将自动调用终止方法：

use app\http\middleware\terminatingmiddleware;
/**
 * register any application services.
 *
 * @return void
 */
public function register()
{
    $this->app->singleton(terminatingmiddleware::class);
}