如何在Laravel中配置路由中间件

如何在 laravel 中配置路由中间件？解决方案主要有三种方式：全局中间件、路由组中间件和单个路由中间件。1. 全局中间件会应用于每一个 http 请求，通过在 app/http/kernel.php 的 $middleware 数组中注册；2. 路由组中间件用于将中间件应用到一组路由，通过在 $middlewaregroups 数组中定义并在路由文件中使用 middleware 方法分配；3. 单个路由中间件允许将中间件应用到具体路由，通过在路由定义时调用 middleware 方法并指定中间件别名。自定义中间件需先使用 artisan 命令创建，并在 handle 方法中编写逻辑，然后在 $routemiddleware 数组中注册别名，以便在路由中引用。此外，中间件支持参数传递，可在路由定义中通过冒号分隔传递参数至 handle 方法。

路由中间件，简单说，就是在请求到达你的控制器之前，或者离开你的控制器之后，执行的一段代码。它就像一个守门员，可以检查用户是否登录，验证权限，或者记录请求日志。配置路由中间件，其实就是在告诉 Laravel，哪些路由需要经过哪些“守门员”的检查。

解决方案

在 Laravel 中配置路由中间件主要有三种方式：全局中间件、路由组中间件和单个路由中间件。

1. 全局中间件: 这类中间件会应用到每一个 HTTP 请求。你可以在 app/Http/Kernel.php 文件的 $middleware 数组中注册全局中间件。例如，Laravel 默认包含的 \App\Http\Middleware\TrustProxies::class 和 \App\Http\Middleware\PreventRequestsDuringMaintenance::class 都是全局中间件。 添加自定义全局中间件，只需要将你的中间件类添加到 $middleware 数组即可。

2. 路由组中间件: 这种方式允许你将中间件应用到一组路由。在 app/Http/Kernel.php 文件的 $middlewareGroups 数组中定义路由组中间件。例如，web 和 api 组是 Laravel 默认提供的。 你可以创建自己的路由组，并在 routes/web.php 或 routes/api.php 中使用 middleware 方法将路由分配到该组。

3. 单个路由中间件: 这是最灵活的方式，允许你将中间件应用到单个路由。 你可以在路由定义中使用 middleware 方法指定中间件。例如：Route::get('/profile', [UserController::class, 'show'])->middleware('auth');。 这里的 auth 是一个已经注册的中间件别名。 中间件别名在 app/Http/Kernel.php 文件的 $routeMiddleware 数组中定义。

中间件的创建:

使用 Artisan 命令 php artisan make:middleware YourMiddlewareName 可以快速创建一个新的中间件。 这个命令会在 app/Http/Middleware 目录下生成一个中间件类。 你需要在 handle 方法中编写中间件的逻辑。

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;

class YourMiddlewareName
{
    /**
     * Handle an incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure(\Illuminate\Http\Request): (\Illuminate\Http\Response|\Illuminate\Http\RedirectResponse)  $next
     * @return \Illuminate\Http\Response|\Illuminate\Http\RedirectResponse
     */
    public function handle(Request $request, Closure $next)
    {
        // 在请求到达控制器之前执行的代码

        $response = $next($request);

        // 在请求离开控制器之后执行的代码

        return $response;
    }
}

$next($request) 这行代码会将请求传递给下一个中间件或控制器。 你可以在这行代码之前和之后添加你的自定义逻辑。

如何在Laravel中注册自定义路由中间件？

注册自定义路由中间件，需要在app/Http/Kernel.php文件的$routeMiddleware数组中添加你的中间件。这个数组是一个键值对，键是中间件的别名，值是中间件类的完全限定名称。例如：

百度文心百中

百度大模型语义搜索体验中心

22

查看详情

protected $routeMiddleware = [
    'auth' => \App\Http\Middleware\Authenticate::class,
    'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
    'cache.headers' => \Illuminate\Http\Middleware\SetCacheHeaders::class,
    'can' => \Illuminate\Auth\Middleware\Authorize::class,
    'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
    'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
    'yourmiddleware' => \App\Http\Middleware\YourMiddlewareName::class, // 添加你的自定义中间件
];

注册完成后，你就可以在路由定义中使用 yourmiddleware 这个别名来应用你的自定义中间件了。

路由中间件和控制器中间件有什么区别？

区别在于应用的位置和方式。路由中间件是在路由定义时直接应用，通过 Route::middleware() 或在 routes/web.php、routes/api.php 文件中指定。控制器中间件则是在控制器内部应用，通常在控制器的构造函数中使用 $this->middleware() 方法。

路由中间件更灵活，可以应用于单个路由、路由组或全局。控制器中间件更方便，可以直接在控制器内部管理中间件。选择哪种方式取决于你的具体需求。如果中间件只应用于特定的控制器，那么控制器中间件可能更合适。如果中间件需要应用于多个控制器或路由，那么路由中间件可能更灵活。

中间件中的参数传递

有些时候，你可能需要在中间件中传递参数。 Laravel 允许你这样做。 例如，你可以定义一个中间件来检查用户是否具有特定的权限。

首先，在你的中间件中接收参数：

public function handle(Request $request, Closure $next, $permission)
{
    if (! $request->user()->hasPermission($permission)) {
        abort(403, 'Unauthorized.');
    }

    return $next($request);
}

然后，在路由定义中传递参数：

Route::get('/admin', [AdminController::class, 'index'])->middleware('permission:edit-articles');

在这个例子中，edit-articles 参数会被传递到 handle 方法的 $permission 参数中。 注意，当传递多个参数时，参数之间用冒号分隔。

这几种配置方式，可以根据实际需求灵活运用，让你的 Laravel 应用更加安全和可控。

以上就是如何在Laravel中配置路由中间件的详细内容，更多请关注php中文网其它相关文章！