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中间件适用于多种常见业务场景:

ModelGate
ModelGate

一站式AI模型管理与调用工具

下载

权限检查

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

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

340

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

293

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

773

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

385

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

141

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

85

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

80

2025.08.05

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

568

2026.03.04

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

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

精品课程

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

共137课时 | 13.5万人学习

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

共6课时 | 11.3万人学习

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

共13课时 | 1.0万人学习

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

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