laravel Kernel 默认中间件说明

66 篇文章 4 订阅

在一个新的laravel项目中,都会默认带上一些中间件,现在来说明一下各中间件的作用

<?php

namespace App\Http;

use Illuminate\Foundation\Http\Kernel as HttpKernel;

class Kernel extends HttpKernel
{
    // 全局中间件
    protected $middleware = [
        // \App\Http\Middleware\TrustHosts::class,

        // 修正代理服务器后的服务器参数
        \App\Http\Middleware\TrustProxies::class,

        // 解决 cors 跨域问题
        \Fruitcake\Cors\HandleCors::class,

        // 检测应用是否进入『维护模式』
        // 见:https://learnku.com/docs/laravel/9.x/configuration#maintenance-mode
        \App\Http\Middleware\PreventRequestsDuringMaintenance::class,

        // 检测表单请求的数据是否过大
        \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,

        // 对所有提交的请求数据进行 PHP 函数 `trim()` 处理
        \App\Http\Middleware\TrimStrings::class,

        // 将提交请求参数中空子串转换为 null
        \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
    ];

    // 设定中间件组
    protected $middlewareGroups = [

        // Web 中间件组,应用于 routes/web.php 路由文件,
        // 在 RouteServiceProvider 中设定
        'web' => [
            // Cookie 加密解密
            \App\Http\Middleware\EncryptCookies::class,

            // 将 Cookie 添加到响应中
            \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,

            // 开启会话
            \Illuminate\Session\Middleware\StartSession::class,
            // \Illuminate\Session\Middleware\AuthenticateSession::class,

            // 将系统的错误数据注入到视图变量 $errors 中
            \Illuminate\View\Middleware\ShareErrorsFromSession::class,

            // 检验 CSRF ,防止跨站请求伪造的安全威胁
            // 见:https://learnku.com/docs/laravel/9.x/csrf
            \App\Http\Middleware\VerifyCsrfToken::class,

            // 处理路由绑定
            // 见:https://learnku.com/docs/laravel/9.x/routing#route-model-binding
            \Illuminate\Routing\Middleware\SubstituteBindings::class
        ],

        // API 中间件组,应用于 routes/api.php 路由文件,
        // 在 RouteServiceProvider 中设定
        'api' => [
            // 使用别名来调用中间件
            // 请见:https://learnku.com/docs/laravel/9.x/middleware#为路由分配中间件
            'throttle:api',
            \Illuminate\Routing\Middleware\SubstituteBindings::class,
        ],
    ];

    // 中间件别名设置,允许你使用别名调用中间件,例如上面的 api 中间件组调用
    protected $routeMiddleware = [
        // 只有登录用户才能访问,我们在控制器的构造方法中大量使用
        'auth' => \App\Http\Middleware\Authenticate::class,

        // HTTP Basic Auth 认证
        'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,

        // 缓存标头
        'cache.headers' => \Illuminate\Http\Middleware\SetCacheHeaders::class,

        // 用户授权功能
        'can' => \Illuminate\Auth\Middleware\Authorize::class,

        // 只有游客才能访问,在 register 和 login 请求中使用,只有未登录用户才能访问这些页面
        'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,

        // 密码确认,你可以在做一些安全级别较高的修改时使用,例如说支付前进行密码确认
        'password.confirm' => \Illuminate\Auth\Middleware\RequirePassword::class,

        // 签名认证,在找回密码章节里我们讲过
        'signed' => \Illuminate\Routing\Middleware\ValidateSignature::class,

        // 访问节流,类似于 『1 分钟只能请求 10 次』的需求,一般在 API 中使用
        'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,

        // Laravel 自带的强制用户邮箱认证的中间件,为了更加贴近我们的逻辑,已被重写
        'verified' => \Illuminate\Auth\Middleware\EnsureEmailIsVerified::class,
    ];
}
  • 1
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
Laravel 中,注册中间件需要遵循以下步骤: 1. 创建中间件类 首先,你需要创建一个中间件类。可以使用 Artisan 命令 `php artisan make:middleware <middleware-name>` 来创建一个新的中间件类。 例如,如果要创建一个名为 `CheckAge` 的中间件,可以运行以下命令: ``` php artisan make:middleware CheckAge ``` 该命令将在 `app/Http/Middleware` 目录中创建一个名为 `CheckAge.php` 的中间件类。 2. 编写中间件逻辑 在中间件类中,你需要实现 `handle` 方法来定义中间件要执行的逻辑。`handle` 方法接收两个参数:`$request` 和 `$next`。 `$request` 是当前请求的实例,而 `$next` 是下一个中间件或路由的闭包。 例如,以下是一个简单的 `CheckAge` 中间件,用于检查用户的年龄是否大于 18 岁: ```php <?php namespace App\Http\Middleware; use Closure; class CheckAge { public function handle($request, Closure $next) { if ($request->age < 18) { return redirect('home'); } return $next($request); } } ``` 在上面的例子中,如果用户的年龄小于 18 岁,则中间件将重定向到 `home` 路由,否则将继续执行下一个中间件或路由。 3. 注册中间件 完成中间件类后,你需要将其注册到应用程序中。可以在 `app/Http/Kernel.php` 文件中找到中间件注册表。 该文件包含了一个 `$middleware` 数组,其中包含了全局中间件。你也可以将中间件分组并定义在 `$middlewareGroups` 数组中,或者将它们定义在单独的 `$routeMiddleware` 数组中,并通过路由中间件来使用它们。 例如,以下是一个将 `CheckAge` 中间件注册为全局中间件的示例: ```php protected $middleware = [ \App\Http\Middleware\CheckAge::class, ]; ``` 或者,你可以将其注册为路由中间件: ```php protected $routeMiddleware = [ 'checkAge' => \App\Http\Middleware\CheckAge::class, ]; ``` 现在,你可以在路由中使用 `checkAge` 中间件来检查用户的年龄: ```php Route::get('profile', function () { // })->middleware('checkAge'); ``` 或者,你可以将其添加到控制器的构造函数中: ```php public function __construct() { $this->middleware('checkAge'); } ``` 以上就是 Laravel 中注册中间件的步骤。希望对你有所帮助!

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

小信啊啊

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值