信息发布→ 登录 注册 退出

Laravel如何创建自定义的验证规则(Validation Rule)

发布时间:2025-11-19

点击量:
Laravel中创建自定义验证规则可通过Artisan命令生成Rule类,如php artisan make:rule Uppercase,生成的类需实现passes方法定义逻辑(如判断字符串是否全大写)和message方法返回错误信息;可在控制器验证中直接使用new Uppercase;支持带参数的规则(如MinUppercase含最小长度),通过构造函数传参并在passes中校验;还可注册为全局规则,在AppServiceProvider中用Validator::extend添加自定义规则(如min_uppercase),并用replacer定义错误消息,之后即可在验证数组中像内置规则一样使用字符串形式调用,推荐使用Rule类管理复杂逻辑以保持代码清晰。

在 Laravel 中创建自定义验证规则非常简单,你可以通过命令生成一个规则类,然后在里面定义自己的逻辑。这种方式让代码更清晰、可复用,并且符合 Laravel 的规范。

使用 Artisan 命令创建自定义规则

运行以下命令来生成一个新的验证规则:

php artisan make:rule Uppercase

这会生成一个位于 app/Rules/Uppercase.php 的类,结构如下:

class Uppercase implements Rule
{
    public function passes($attribute, $value)
    {
        // 验证逻辑:判断字符串是否全为大写
        return strtoupper($value) === $value;
    }

    public function message()
    {
        return 'The :attribute must be uppercase.';
    }
}

在表单请求或控制器中使用自定义规则

你可以在控制器的验证逻辑中直接使用这个规则:

use App\Rules\Uppercase;

$request->validate([
    'name' => ['required', new Uppercase],
]);

如果输入的 name 不是大写,就会返回你定义的错误信息。

带参数的自定义规则

如果你想让规则更灵活,比如限制字符串最小长度的同时检查大写,可以传参:

// 生成规则
php artisan make:rule MinUppercase

class MinUppercase implements Rule
{
    private $min;

    public function __construct($min)
    {
        $this->min = $min;
    }

    public function passes($attribute, $value)
    {
        return strlen($value) >= $this->min && strtoupper($value) === $value;
    }

    public function message()
    {
        return 'The :attribute must be uppercase and at least '.$this->min.' characters.';
    }
}

使用时传入参数:

$request->validate([
    'name' => ['required', new MinUppercase(5)],
]);

注册为全局验证规则(可选)

如果你希望像内置规则一样使用自定义规则(如 'min_uppercase:5'),可以在 AppServiceProvider@boot 中扩展 Validator:

use Illuminate\Support\Facades\Validator;
Validator::extend('min_uppercase', function ($attribute, $value, $parameters, $validator) {
    $min = $parameters[0] ?? 1;
    return strlen($value) >= $min && strtoupper($value) === $value;
});

// 错误消息
Validator::replacer('min_uppercase', function ($message, $attribute, $rule, $parameters) {
    return str_replace(':attribute', $attribute, '必须至少 :min 个字符且为大写。');
});

之后就可以在验证中这样写:

'name' => 'required|min_uppercase:5'

基本上就这些。Laravel 的自定义规则机制很灵活,推荐优先使用 Rule 类的方式组织复杂验证逻辑,保持代码整洁易维护。

标签:# function  # 可选  # 可在  # 并在  # 推荐使用  # 就会  # 自己的  # 错误信息  # 你可以  # 如果你  # 自定义  # this  # php  # Attribute  # private  # public  # class  # 字符串  # 构造函数  # strlen  # red  # app  # cad  # laravel  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!