0

0

Laravel中间件怎么创建_Laravel中间件编写使用及实际应用场景介绍

絕刀狂花

絕刀狂花

发布时间:2025-11-25 20:25:02

|

312人浏览过

|

来源于php中文网

原创

Laravel中间件用于处理HTTP请求与响应,可实现权限控制、日志记录等通用逻辑。通过php artisan make:middleware CheckAge命令生成中间件,位于app/Http/Middleware目录,核心为handle方法,接收请求对象和$next回调,可在前后插入前置或后置逻辑。中间件需注册使用,分为三种方式:1. 全局中间件,在app/Http/Kernel.php的$middleware属性中注册,作用于所有请求;2. 路由中间件,在$routeMiddleware数组中定义别名并绑定类,如'check.age' => \App\Http\Middleware\CheckAge::class,再在路由中通过->middleware('check.age')应用;3. 中间件分组,将多个中间件组合成组(如web、api),便于批量调用。典型应用场景包括权限检查(如判断用户是否有编辑权限)、维护模式控制(非管理员重定向至维护页)、请求日志记录(前后记录URL和状态码)以及防止表单重复提交(校验Token)。中间件支持参数传递,例如role:admin可向handle($request, $next, $role)传参,多个参数用逗号分隔。执行顺序按注册顺序正向执行,响应时逆序返回,正确

laravel中间件怎么创建_laravel中间件编写使用及实际应用场景介绍

在Laravel中,中间件是处理HTTP请求和响应的强有力工具。它位于用户请求与应用逻辑之间,可用于过滤、验证、记录日志、权限控制等操作。通过中间件,你可以优雅地实现跨多个路由的通用逻辑。

创建Laravel中间件

使用Artisan命令可以快速生成中间件:

php artisan make:middleware CheckAge

该命令会在app/Http/Middleware目录下生成一个名为CheckAge.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);
    }
}

其中handle方法接收请求对象和下一个中间件回调$next。你可以在调用$next($request)前后插入逻辑,实现“前置”或“后置”处理。

注册和使用中间件

中间件需要注册后才能使用,分为全局中间件、路由中间件和分组中间件三种方式。

1. 全局中间件

app/Http/Kernel.php$middleware属性中添加,会作用于所有请求。

2. 路由中间件

Kernel.php$routeMiddleware数组中注册:

'check.age' => \App\Http\Middleware\CheckAge::class,

然后在路由中使用:

Route::get('/dashboard', function () {
    //
})->middleware('check.age');

3. 中间件分组

可将多个中间件组合为一组,便于复用:

// 在 Kernel.php 中
protected $middlewareGroups = [
    'web' => [
        \App\Http\Middleware\EncryptCookies::class,
        \Illuminate\Session\Middleware\StartSession::class,
        // ...
    ],
];

默认webapi组已内置,可通过middleware('web')应用整组中间件。

实际应用场景示例

Laravel中间件适用于多种常见业务场景:

火山方舟
火山方舟

火山引擎一站式大模型服务平台,已接入满血版DeepSeek

下载

权限检查

判断用户是否有访问某页面的权限:

public function handle($request, Closure $next)
{
    if (! auth()->user()?->hasPermission('edit-posts')) {
        abort(403, '无权访问');
    }

    return $next($request);
}

维护模式控制

临时关闭某些功能路径:

if (config('app.maintenance_mode') && ! $request->user()?->isAdmin()) {
    return redirect('/maintenance');
}

日志记录

记录请求信息用于调试或监控:

Log::info('Request started: ' . $request->url());

$response = $next($request);

Log::info('Response sent: ' . $response->getStatusCode());

return $response;

防止重复提交

利用Token机制限制表单重复提交:

if (session('form_token') !== $request->input('token')) {
    return back()->withErrors('非法请求');
}

中间件参数传递

中间件支持接收额外参数。例如定义一个检查用户角色的中间件:

public function handle($request, Closure $next, $role)
{
    if (! $request->user() || $request->user()->role !== $role) {
        return redirect('home');
    }

    return $next($request);
}

注册后在路由中使用:

middleware('role:admin')

多个参数可用逗号分隔:middleware('role:editor,publisher')

基本上就这些。Laravel中间件机制灵活且易于扩展,合理使用能显著提升代码可维护性和安全性。不复杂但容易忽略的是中间件执行顺序——按注册顺序从前到后执行,返回响应时则逆序回传。掌握这一点有助于避免逻辑错乱。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2409

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1552

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1449

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

951

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1414

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1233

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1445

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1305

2023.11.13

Java 项目构建与依赖管理(Maven / Gradle)
Java 项目构建与依赖管理(Maven / Gradle)

本专题系统讲解 Java 项目构建与依赖管理的完整体系,重点覆盖 Maven 与 Gradle 的核心概念、项目生命周期、依赖冲突解决、多模块项目管理、构建加速与版本发布规范。通过真实项目结构示例,帮助学习者掌握 从零搭建、维护到发布 Java 工程的标准化流程,提升在实际团队开发中的工程能力与协作效率。

3

2026.01.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.5万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 6.9万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号