Laravel如何配置中间件Middleware_Laravel自定义中间件拦截请求与权限校验【步骤】
发布时间 - 2026-01-01 00:00:00 点击率:次注册自定义中间件需先在app/Http/Kernel.php的$routeMiddleware中声明别名(如'auth.check' => \App\Http\Middleware\CheckAuth::class),再在路由或控制器中引用;handle方法必须显式return响应或$next($request),否则请求中断。
如何注册自定义中间件到 Laravel 路由或控制器
自定义中间件必须先注册,否则 app/Http/Kernel.php 不认识它,路由里用 middleware 会报 Class not found 错误。
注册分两步:先在 app/Http/Kernel.php 中声明别名,再在路由或控制器中引用该别名。
- 在
$routeMiddleware数组里添加键值对,例如:'auth.check' => \App\Http\Middleware\CheckAuth::class - 别名不能含点号(
.)以外的特殊字符,推荐用小写+点号分隔,如permission.update - 如果想全局生效(所有请求都走),加到
$middleware数组,但慎用——会影响性能且可能拦截静态资源 - 控制器构造函数中绑定中间件需用
$this->middleware('auth.check'),不是数组形式
Laravel 中间件 handle 方法里怎么终止请求并返回响应
中间件不 return 就等于没拦截,Laravel 会继续往下执行后续中间件和控制器。常见错误是只写了逻辑判断,却忘了 return 响应对象。
终止请求必须显式 return 一个 Response 实例(或兼容响应的内容),不能只用 abort() 或 dd() —— 后者会中断整个流程但不返回 HTTP 响应,前端收不到状态码。
public function handle($request, Closure $next)
{
if (! $request->user() || ! $request->user()->hasRole('admin')) {
return response()->json(['message' => 'Forbidden'], 403);
}
return $next($request);
}
-
response()->json()、redirect()、view()都是合法返回值 - 不要在
handle里调用exit或die,会绕过 Laravel 的异常处理和事件调度
- 若需重定向登录页,用
return redirect()->guest('login')比硬编码 URL 更安全
权限校验类中间件如何动态读取路由参数或控制器方法
单纯判断用户是否登录不够,真实权限常依赖当前操作的资源 ID 或控制器动作(比如只允许编辑自己创建的文章)。这时需要从请求中提取上下文。
Laravel 的 $request 对象能拿到路由参数、查询参数、请求体,甚至通过反射获取控制器和方法名,但要注意时机——路由已解析完才可用 $request->route()。
- 获取当前路由参数:
$request->route('id')(假设路由定义为post/{id}) - 获取当前控制器和方法:
$request->route()->getControllerName()和$request->route()->getActionName() - 检查请求是否为特定 HTTP 方法:
$request->isMethod('PUT')或$request->method() === 'DELETE' - 避免在中间件里查数据库做复杂权限判断,建议预加载或缓存策略,否则每次请求都查库会拖慢响应
为什么中间件里 $next($request) 放错位置会导致 500 或空白响应
把 $next($request) 写在条件分支外但没包在 else 里,或者放在 return 后面,PHP 会报 Fatal error: Uncaught Error: Call to a member function send() on null,因为 Laravel 最终没收到响应对象。
典型错误写法:
if ($user->can('delete')) {
// 忘了 return $next($request);
}
// 这里没有 else,也没有 return,流程走到末尾时函数无返回值
- 每个分支路径最终都必须有
return:要么返回响应,要么返回$next($request) - 不要在
if块里只写逻辑、不 return,也不要在else里漏掉$next - 调试时可在
handle开头加Log::debug('middleware hit'),确认是否真的执行到了
中间件链是线性的,少一次 return $next() 就断在那一环,后面所有中间件和控制器都不会执行。这个细节在嵌套多层权限校验时特别容易被忽略。
# php
# laravel
# js
# 前端
# json
# 编码
# app
# 路由
# 状态码
# 键值对
# 为什么
# red
# 中间件
# NULL
# if
# 构造函数
# die
# Error
# class
# delete
# function
# 对象
# 事件
# this
# 数据库
# http
# 会报
# 自定义
# 先在
# 返回值
# 都是
# 器中
# 也不
# 放在
# 走到
# 不要在
相关栏目:
【
网站优化151355 】
【
网络推广146373 】
【
网络技术251813 】
【
AI营销90571 】
相关推荐:
网站制作大概要多少钱一个,做一个平台网站大概多少钱?
Laravel怎么配置不同环境的数据库_Laravel本地测试与生产环境动态切换【方法】
Laravel如何处理CORS跨域问题_Laravel项目CORS配置与解决方案
如何实现建站之星域名转发设置?
如何基于云服务器快速搭建个人网站?
如何在阿里云虚拟主机上快速搭建个人网站?
Laravel Facade的原理是什么_深入理解Laravel门面及其工作机制
Windows10怎样连接蓝牙设备_Windows10蓝牙连接步骤【教程】
java获取注册ip实例
Python文本处理实践_日志清洗解析【指导】
如何在香港免费服务器上快速搭建网站?
家族网站制作贴纸教程视频,用豆子做粘帖画怎么制作?
Laravel如何处理JSON字段的查询和更新_Laravel JSON列操作与查询技巧
EditPlus中的正则表达式 实战(1)
Laravel如何使用Livewire构建动态组件?(入门代码)
laravel怎么为应用开启和关闭维护模式_laravel应用维护模式开启与关闭方法
如何在建站之星绑定自定义域名?
如何解决hover在ie6中的兼容性问题
Swift中swift中的switch 语句
如何快速查询网站的真实建站时间?
Gemini怎么用新功能实时问答_Gemini实时问答使用【步骤】
Laravel如何使用.env文件管理环境变量?(最佳实践)
如何快速搭建安全的FTP站点?
Laravel中的withCount方法怎么高效统计关联模型数量
Laravel怎么使用Markdown渲染文档_Laravel将Markdown内容转HTML页面展示【实战】
如何登录建站主机?访问步骤全解析
如何彻底卸载建站之星软件?
JavaScript常见的五种数组去重的方式
Win11怎么恢复误删照片_Win11数据恢复工具使用【推荐】
Thinkphp 中 distinct 的用法解析
个人网站制作流程图片大全,个人网站如何注销?
如何在Windows环境下新建FTP站点并设置权限?
Laravel如何实现用户角色和权限系统_Laravel角色权限管理机制
如何用PHP快速搭建高效网站?分步指南
在Oracle关闭情况下如何修改spfile的参数
如何快速搭建高效香港服务器网站?
Laravel如何实现邮件验证激活账户_Laravel内置MustVerifyEmail接口配置【步骤】
千问怎样用提示词获取健康建议_千问健康类提示词注意事项【指南】
laravel怎么实现图片的压缩和裁剪_laravel图片压缩与裁剪方法
java ZXing生成二维码及条码实例分享
浅析上传头像示例及其注意事项
如何在阿里云完成域名注册与建站?
Laravel怎么生成二维码图片_Laravel集成Simple-QrCode扩展包与参数设置【实战】
如何用低价快速搭建高质量网站?
在线ppt制作网站有哪些软件,如何把网页的内容做成ppt?
JS碰撞运动实现方法详解
Win10如何卸载预装Edge扩展_Win10卸载Edge扩展教程【方法】
Win11怎么关闭透明效果_Windows11辅助功能视觉效果设置
php打包exe后无法访问网络共享_共享权限设置方法【教程】
Laravel怎么定时执行任务_Laravel任务调度器Schedule配置与Cron设置【教程】


