0

0

Laravel中如何使用表单请求类_Laravel FormRequest验证数据方法【详解】

尼克

尼克

发布时间:2026-01-22 13:11:17

|

787人浏览过

|

来源于php中文网

原创

Laravel 的 FormRequest 是推荐替代 $request->validate() 的标准做法,适用于规则复用、授权控制、自定义错误响应或含复杂逻辑的场景;需重写 authorize() 和 rules() 方法,并通过类型提示自动注入使用。

laravel中如何使用表单请求类_laravel formrequest验证数据方法【详解】

直接说结论:Laravel 的 FormRequest 不是“可选的验证方式”,而是推荐在控制器方法中替代手写 $request->validate() 的标准做法——前提是你的表单逻辑有复用性、需授权控制或要集中管理规则。

什么时候该用 FormRequest 而不是 $request->validate()

不是所有表单都值得单独建一个类。以下情况才建议拆出 FormRequest

  • 同一个验证规则被多个控制器方法调用(比如后台和 API 都要创建用户)
  • 需要在验证前做权限判断(例如 authorize() 中检查当前用户能否编辑该资源)
  • 验证失败时要自定义错误响应格式(如返回 JSON 而非重定向)
  • 规则里包含复杂逻辑(如“当 status 为 draft 时,publish_at 必须为空”),放 rules() 方法里比塞进控制器更清晰

如何生成并配置一个 StorePostRequest

运行 Artisan 命令生成类:

php artisan make:request StorePostRequest

生成后需手动修改两个关键方法:

  • authorize():返回 true 允许继续,false 直接 403;常用来查 Auth::user()->can('create', Post::class)
  • rules():返回规则数组,字段名必须与前端提交的键一致;支持闭包、Rule::exists() 等高级用法

示例:

public function rules()
{
    return [
        'title' => 'required|string|max:255',
        'content' => 'required|string',
        'category_id' => 'required|exists:categories,id',
        'tags' => 'array',
        'tags.*' => 'string|exists:tags,name',
    ];
}

在控制器中使用 FormRequest 的正确姿势

不要手动实例化,也不要传 Request 再调 validate() —— Laravel 会自动注入并触发验证流程:

MCP Market
MCP Market

MCP Servers集合平台,帮你找到最好的MCP服务器

下载
public function store(StorePostRequest $request)
{
    // 此处 $request 已通过验证,且 authorize() 已执行
    $post = Post::create($request->validated());
    return redirect()->route('posts.index');
}

注意几个易错点:

  • 参数类型提示必须是具体的 FormRequest 子类,不能是 RequestFormRequest 父类
  • $request->validated() 只返回通过规则的字段,比 $request->all() 更安全
  • 若需获取原始输入(包括未通过验证的字段),用 $request->all(),但需自行过滤
  • 验证失败默认重定向回上一页(带错误和旧输入),API 场景下会返回 JSON 错误,无需额外处理

常见问题为什么 authorize() 总返回 false?

这是最常被忽略的一环。Laravel 默认实现是 return false;,你必须显式改写:

public function authorize()
{
    // 比如只允许管理员创建文章
    return Auth::check() && Auth::user()->is_admin;
}

如果忘记改,所有请求都会被拦截并返回 403,且不报具体错误——日志里也看不到验证失败记录,容易误判为路由或中间件问题。

另外,authorize() 在验证规则执行前就运行,所以它不能依赖 $request->input() 中的值(除非你确认该字段一定存在且已通过初步过滤)。

相关专题

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

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

319

2024.04.09

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

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

276

2024.04.09

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

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

370

2024.04.09

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

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

371

2024.04.10

laravel入门教程
laravel入门教程

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

81

2025.08.05

laravel实战教程
laravel实战教程

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

64

2025.08.05

laravel面试题
laravel面试题

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

67

2025.08.05

什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

178

2024.05.11

Golang 性能分析与pprof调优实战
Golang 性能分析与pprof调优实战

本专题系统讲解 Golang 应用的性能分析与调优方法,重点覆盖 pprof 的使用方式,包括 CPU、内存、阻塞与 goroutine 分析,火焰图解读,常见性能瓶颈定位思路,以及在真实项目中进行针对性优化的实践技巧。通过案例讲解,帮助开发者掌握 用数据驱动的方式持续提升 Go 程序性能与稳定性。

6

2026.01.22

热门下载

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

精品课程

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

共137课时 | 9.1万人学习

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

共6课时 | 9.6万人学习

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

共13课时 | 0.9万人学习

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

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