laravel 验证规则大全及案例

Laravel 提供了丰富的验证规则，涵盖常见的数据验证需求。以下是常用的 Laravel 验证规则及其对应的示例，帮助你更好地理解和使用这些规则。

---

基本验证规则

规则	描述	示例
required	必须存在字段。	'name' => 'required'
nullable	字段可以为空，但如果存在必须通过其他验证	'name' => 'nullable'
filled	字段非空时才进行验证	'name' => 'filled'
present	字段必须存在，但可以为空	'name' => 'present'
sometimes	有时需要验证（配合 Validator 使用）	'name' => 'sometimes'

字符串和数值规则

规则	描述	示例
string	必须是字符串	'name' => 'string'
integer	必须是整数	'age' => 'integer'
numeric	必须是数值	'price' => 'numeric'
boolean	必须是布尔值	'active' => 'boolean'
array	必须是数组	'tags' => 'array'
json	必须是 JSON 字符串	'settings' => 'json'
digits	必须是指定长度的数字	'pin' => 'digits:4'
digits_between	必须是指定范围内的数字长度	'phone' => 'digits_between:10,15'
min	最小值（数字、字符串、文件或数组）	'age' => 'min:18'
max	最大值（数字、字符串、文件或数组）	'title' => 'max:255'

日期和时间规则

规则	描述	示例
date	必须是有效日期	'published_at' => 'date'
date_format	必须符合指定格式	'date' => 'date_format:Y-m-d'
before	必须是指定日期之前	'start_date' => 'before:end_date'
after	必须是指定日期之后	'end_date' => 'after:start_date'
before_or_equal	必须是指定日期或之前	'start_date' => 'before_or_equal:today'
after_or_equal	必须是指定日期或之后	'end_date' => 'after_or_equal:start_date'

文件和图片规则

规则	描述	示例
file	必须是文件	'document' => 'file'
image	必须是图片文件（jpeg、png 等）	'avatar' => 'image'
mimes	文件 MIME 类型必须是指定类型	'avatar' => 'mimes:jpeg,png'
mimetypes	文件 MIME 类型必须是指定 MIME	'avatar' => 'mimetypes:image/jpeg'
size	文件大小（单位：KB）	'document' => 'size:1024'
max	文件最大大小	'document' => 'max:2048'
dimensions	图片的最小/最大宽度、高度	'avatar' => 'dimensions:min_width=100,min_height=200'

字符串和格式规则

规则	描述	示例
email	必须是有效的邮箱地址	'email' => 'email'
url	必须是有效的 URL	'website' => 'url'
ip	必须是有效的 IP 地址	'ip_address' => 'ip'
uuid	必须是有效的 UUID	'id' => 'uuid'
regex	必须符合正则表达式	'username' => 'regex:/^[A-Za-z0-9]+$/'
alpha	只能包含字母	'name' => 'alpha'
alpha_dash	只能包含字母、数字、破折号和下划线	'username' => 'alpha_dash'
alpha_num	只能包含字母和数字	'username' => 'alpha_num'

比较规则

规则	描述	示例
same	必须与指定字段的值相同	'password_confirmation' => 'same:password'
different	必须与指定字段的值不同	'old_password' => 'different:new_password'
gt	必须大于指定字段的值	'age' => 'gt:18'
gte	必须大于或等于指定字段的值	'quantity' => 'gte:min_quantity'
lt	必须小于指定字段的值	'age' => 'lt:60'
lte	必须小于或等于指定字段的值	'quantity' => 'lte:max_quantity'
in	值必须在指定的列表中	'status' => 'in:pending,approved'
not_in	值必须不在指定的列表中	'status' => 'not_in:banned'

数组和 JSON 规则

规则	描述	示例
array	必须是一个数组	'tags' => 'array'
distinct	数组的每个元素必须唯一	'tags.*' => 'distinct'
size	数组必须包含指定数量的元素	'tags' => 'size:3'
min	数组元素的最小数量	'tags' => 'min:1'
max	数组元素的最大数量	'tags' => 'max:5'

特定字段条件验证

规则	描述	示例
required_if	如果指定字段为某值时，字段是必填	'reason' => 'required_if:status,rejected'
required_unless	如果指定字段不为某值时，字段是必填	'reason' => 'required_unless:status,approved'
required_with	如果任一指定字段存在，则字段是必填	'field' => 'required_with:field1,field2'
required_with_all	如果所有指定字段存在，则字段是必填	'field' => 'required_with_all:field1,field2'
required_without	如果任一指定字段不存在，则字段是必填	'field' => 'required_without:field1'
required_without_all	如果所有指定字段都不存在，则字段是必填	'field' => 'required_without_all:field1,field2'

数据库验证规则

规则	描述	示例
unique	必须在数据库中唯一	'email' => 'unique:users,email'
exists	必须存在于数据库的指定表字段中	'user_id' => 'exists:users,id'

自定义错误消息

你可以在验证中添加自定义错误消息，以便更好地提示用户：

public function messages()
{
    return [
        'name.required' => '请提供您的姓名。',
        'email.unique' => '该邮箱地址已被注册。',
    ];
}

案例示例

以下是一个表单请求验证的综合示例：

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class StoreUserRequest extends FormRequest
{
    public function rules()
    {
        return [
            'name' => 'required|string|max:255',
            '

email' => 'required|email|unique:users,email',
            'password' => 'required|string|min:8|confirmed',
            'age' => 'nullable|integer|gt:0',
            'birth_date' => 'nullable|date|before:today',
            'profile_image' => 'nullable|image|mimes:jpeg,png|max:1024',
        ];
    }

    public function messages()
    {
        return [
            'name.required' => '姓名为必填项。',
            'email.unique' => '该邮箱已被注册。',
            'password.confirmed' => '两次密码输入不一致。',
            'birth_date.before' => '出生日期必须是过去的日期。',
        ];
    }
}

---

通过灵活使用这些规则，你可以更好地掌控数据的验证逻辑，提升应用的安全性和用户体验。