讲师中心 微信公众号
AI工具推荐 视频效率加速

Laravel自定义验证规则怎么封装

雨磊吖_4258

雨磊吖_4258

发布时间:2026-09-13 13:08:26

|

331人浏览过

|

来源于php中文网

原创

最轻量注册验证规则用Validator::extend()闭包,但复用难;推荐自定义FormRequest类+抽象基类,或实现Rule接口的独立验证类,兼顾可测性、可维护性与场景动态适配。

laravel自定义验证规则怎么封装

直接用 Validator::extend() 注册闭包最轻量,但跨项目复用难;真要封装,优先走自定义 FormRequest 类 + 抽象基类路线,而不是硬塞一堆 Validator::extend()

Validator::extend() 写闭包规则,适合一次性、简单逻辑

比如验证手机号是否以 13/15/18 开头:

Validator::extend('cn_mobile', function ($attribute, $value, $parameters) {
    return preg_match('/^1[358]\d{9}$/', $value);
});

注意三点:

  • 必须同时在语言文件 resources/lang/en/validation.phpmessages() 方法里加错误提示,否则报错时显示 The :attribute is invalid.
  • 闭包里不能直接访问 $this,没法调用模型或服务,复杂校验(如查库、调 API)不适合放这里
  • 多个项目共用时,得重复粘贴注册代码,容易漏掉或版本不一致

封装成独立验证类,适合复用、可测试、带上下文

新建 app/Validation/Rules/CnMobileRule.php

namespace App\Validation\Rules;

use Illuminate\Contracts\Validation\Rule;

class CnMobileRule implements Rule
{
    public function passes($attribute, $value)
    {
        return preg_match('/^1[358]\d{9}$/', $value) === 1;
    }

    public function message()
    {
        return '手机号格式不正确。';
    }
}

控制器或 FormRequest 中直接用:

'phone' => ['required', new CnMobileRule]

优势很明显:

Laravel
Laravel

避免常见的Laravel错误:N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载
  • 类可被 phpunit 单独测试,闭包做不到
  • 支持构造参数,比如 new CnMobileRule($countryCode)
  • 错误消息写在类里,不依赖语言文件,迁移成本低

FormRequest 里动态组合规则,适合多场景复用同一请求类

比如一个 UpdateProfileRequest 要适配「普通用户」和「企业用户」两种提交路径:

public function rules()
{
    $base = [
        'name' => 'required|string|max:50',
        'avatar' => 'nullable|image|mimes:jpg,jpeg,png|max:2048',
    ];

    if ($this->routeIs('api.enterprise.*')) {
        return array_merge($base, [
            'company_name' => 'required|string',
            'license_no' => 'required|unique:enterprises',
        ]);
    }

    return $base;
}

关键点:

  • 别把所有规则堆进一个大数组,用 $this->routeIs()$this->isMethod('PUT')$this->user()?->isEnterprise() 动态判断
  • 避免在 rules() 里做 DB 查询,性能差;查库逻辑应放到 withValidator() 或单独服务里
  • 如果规则分支太多,建议拆成 UpdatePersonalProfileRequestUpdateEnterpriseProfileRequest,别强求“一个类打天下”

扩展 Validator 类本身,适合全局统一行为(慎用)

比如所有 unique 规则默认忽略软删除记录:

Validator::extend('unique_soft', function ($attribute, $value, $parameters, $validator) {
    $table = $parameters[0];
    $column = $parameters[1] ?? 'id';
    return DB::table($table)->where($column, $value)->withoutTrashed()->count() === 0;
});

但更稳妥的做法是:

  • Rule::unique('users')->ignoreSoftDeleted()(Laravel 9+)
  • 或封装一个 UniqueSoftRule 类,而不是污染全局 Validator
  • 一旦扩展了 Validator,升级 Laravel 时容易因底层变更挂掉,维护成本高

真正需要封装的不是“怎么写规则”,而是“怎么让规则随业务场景自动切换、可测、不散落”。闭包适合临时补丁,类规则适合长期维护,FormRequest 基类才是中大型项目里最常被忽略又最关键的封装层。

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

相关专题

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

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

817

2024.04.09

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

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

795

2024.04.09

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

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

2328

2024.04.09

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

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

3201

2024.04.10

laravel入门教程
laravel入门教程

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

4430

2025.08.05

laravel实战教程
laravel实战教程

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

2976

2025.08.05

laravel面试题
laravel面试题

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

5709

2025.08.05

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

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

1336

2026.03.04

AI视频生成软件推荐
AI视频生成软件推荐

本专题汇总了当前主流的AI视频生成软件推荐与排行榜单,涵盖seko、AniShort、剧云、Lovart、LiblibAI及立刻mv等热门工具。同时整理了各软件在文生视频、图生视频、时长限制、画质表现及免费额度等方面的差异对比,助您快速选对适合创作需求的AI视频生成工具。

160

2026.09.16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何安装 Composer
如何安装 Composer

共1课时 | 174人学习

Composer手册
Composer手册

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn