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

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

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

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

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

这会生成一个位于 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 不是大写，就会返回你定义的错误信息。

带参数的自定义规则

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

Rustic AI

AI驱动的创意设计平台

108

查看详情

// 生成规则
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 类的方式组织复杂验证逻辑，保持代码整洁易维护。

以上就是Laravel如何创建自定义的验证规则(Validation Rule)的详细内容，更多请关注php中文网其它相关文章！