Laravel Validation Rules (13.x)

Complete reference for all 109 validation rules in Laravel 13.x. Search, browse by category, and copy rules instantly.

K

Booleans

accepted The field under validation must be "yes", "on", 1, "1", true, or "true". This is useful for validating "Terms of Service" acceptance or similar fields.

Usage

'field' => 'accepted'

Description

The field under validation must be "yes", "on", 1, "1", true, or "true". This is useful for validating "Terms of Service" acceptance or similar fields.

accepted_if:anotherfield,value,... The field under validation must be "yes", "on", 1, "1", true, or "true" if another field under validation is equal to a specified value. This is useful for validating "Terms of Service" acceptance or similar fields.

Usage

'field' => 'accepted_if:anotherfield,value,...'

Description

The field under validation must be "yes", "on", 1, "1", true, or "true" if another field under validation is equal to a specified value. This is useful for validating "Terms of Service" acceptance or similar fields.

boolean The field under validation must be able to be cast as a boolean. Accepted input are true, false, 1, 0, "1", and "0".

Usage

'field' => 'boolean'

Description

The field under validation must be able to be cast as a boolean. Accepted input are true, false, 1, 0, "1", and "0".

Examples

'foo' => 'boolean:strict'

declined The field under validation must be "no", "off", 0, "0", false, or "false".

Usage

'field' => 'declined'

Description

The field under validation must be "no", "off", 0, "0", false, or "false".

declined_if:anotherfield,value,... The field under validation must be "no", "off", 0, "0", false, or "false" if another field under validation is equal to a specified value.

Usage

'field' => 'declined_if:anotherfield,value,...'

Description

The field under validation must be "no", "off", 0, "0", false, or "false" if another field under validation is equal to a specified value.

Strings

active_url The field under validation must have a valid A or AAAA record according to the dns_get_record PHP function. The hostname of the provided URL is extracted using the parse_url PHP function before being passed to dns_get_record.

Usage

'field' => 'active_url'

Description

The field under validation must have a valid A or AAAA record according to the dns_get_record PHP function. The hostname of the provided URL is extracted using the parse_url PHP function before being passed to dns_get_record.

alpha The field under validation must be entirely Unicode alphabetic characters contained in \p{L} and \p{M}.

Usage

'field' => 'alpha'

Description

The field under validation must be entirely Unicode alphabetic characters contained in \p{L} and \p{M}.

Examples

'username' => 'alpha:ascii',

alpha_dash The field under validation must be entirely Unicode alpha-numeric characters contained in \p{L}, \p{M}, \p{N}, as well as ASCII dashes (-) and ASCII underscores (_).

Usage

'field' => 'alpha_dash'

Description

The field under validation must be entirely Unicode alpha-numeric characters contained in \p{L}, \p{M}, \p{N}, as well as ASCII dashes (-) and ASCII underscores (_).

Examples

'username' => 'alpha_dash:ascii',

alpha_num The field under validation must be entirely Unicode alpha-numeric characters contained in \p{L}, \p{M}, and \p{N}.

Usage

'field' => 'alpha_num'

Description

The field under validation must be entirely Unicode alpha-numeric characters contained in \p{L}, \p{M}, and \p{N}.

Examples

'username' => 'alpha_num:ascii',

ascii The field under validation must be entirely 7-bit ASCII characters.

Usage

'field' => 'ascii'

Description

The field under validation must be entirely 7-bit ASCII characters.

confirmed The field under validation must have a matching field of {field}_confirmation. For example, if the field under validation is password, a matching password_confirmation field must be present in the input.

Usage

'field' => 'confirmed'

Description

The field under validation must have a matching field of {field}_confirmation. For example, if the field under validation is password, a matching password_confirmation field must be present in the input.

current_password The field under validation must match the authenticated user's password. You may specify an authentication guard using the rule's first parameter:

Usage

'field' => 'current_password'

Description

The field under validation must match the authenticated user's password. You may specify an authentication guard using the rule's first parameter:

Examples

'password' => 'current_password:api'

doesnt_end_with:_foo_,_bar_,... The field under validation must not end with one of the given values.

Usage

'field' => 'doesnt_end_with:_foo_,_bar_,...'

Description

The field under validation must not end with one of the given values.

doesnt_start_with:_foo_,_bar_,... The field under validation must not start with one of the given values.

Usage

'field' => 'doesnt_start_with:_foo_,_bar_,...'

Description

The field under validation must not start with one of the given values.

email The field under validation must be formatted as an email address. This validation rule utilizes the egulias/email-validator package for validating the email address.

Usage

'field' => 'email'

Description

The field under validation must be formatted as an email address. This validation rule utilizes the egulias/email-validator package for validating the email address.

Examples

'email' => 'email:rfc,dns'

use Illuminate\Validation\Rule;

$request->validate([
    'email' => [
        'required',
        Rule::email()
            ->rfcCompliant(strict: false)
            ->validateMxRecord()
            ->preventSpoofing()
    ],
]);

ends_with:_foo_,_bar_,... The field under validation must end with one of the given values.

Usage

'field' => 'ends_with:_foo_,_bar_,...'

Description

The field under validation must end with one of the given values.

enum The Enum rule is a class-based rule that validates whether the field under validation contains a valid enum value. The Enum rule accepts the name of the enum as its only constructor argument.

Usage

'field' => 'enum'

Description

The Enum rule is a class-based rule that validates whether the field under validation contains a valid enum value. The Enum rule accepts the name of the enum as its only constructor argument.

Examples

use App\Enums\ServerStatus;
use Illuminate\Validation\Rule;

$request->validate([
    'status' => [Rule::enum(ServerStatus::class)],
]);

Rule::enum(ServerStatus::class)
    ->only([ServerStatus::Pending, ServerStatus::Active]);

Rule::enum(ServerStatus::class)
    ->except([ServerStatus::Pending, ServerStatus::Active]);

use Illuminate\Support\Facades\Auth;
use Illuminate\Validation\Rule;

Rule::enum(ServerStatus::class)
    ->when(
        Auth::user()->isAdmin(),
        fn ($rule) => $rule->only(...),
        fn ($rule) => $rule->only(...),
    );

hex_color The field under validation must contain a valid color value in hexadecimal format.

Usage

'field' => 'hex_color'

Description

The field under validation must contain a valid color value in hexadecimal format.

in:_foo_,_bar_,... The field under validation must be included in the given list of values. Since this rule often requires you to implode an array, the Rule::in method may be used to fluently construct the rule:

Usage

'field' => 'in:_foo_,_bar_,...'

Description

The field under validation must be included in the given list of values. Since this rule often requires you to implode an array, the Rule::in method may be used to fluently construct the rule:

Examples

use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rule;

Validator::make($data, [
    'zones' => [
        'required',
        Rule::in(['first-zone', 'second-zone']),
    ],
]);

use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rule;

$input = [
    'airports' => ['NYC', 'LAS'],
];

Validator::make($input, [
    'airports' => [
        'required',
        'array',
    ],
    'airports.*' => Rule::in(['NYC', 'LIT']),
]);

ip The field under validation must be an IP address.

Usage

'field' => 'ip'

Description

The field under validation must be an IP address.

json The field under validation must be a valid JSON string.

Usage

'field' => 'json'

Description

The field under validation must be a valid JSON string.

lowercase The field under validation must be lowercase.

Usage

'field' => 'lowercase'

Description

The field under validation must be lowercase.

mac_address The field under validation must be a MAC address.

Usage

'field' => 'mac_address'

Description

The field under validation must be a MAC address.

not_in:_foo_,_bar_,... The field under validation must not be included in the given list of values. The Rule::notIn method may be used to fluently construct the rule:

Usage

'field' => 'not_in:_foo_,_bar_,...'

Description

The field under validation must not be included in the given list of values. The Rule::notIn method may be used to fluently construct the rule:

Examples

use Illuminate\Validation\Rule;

Validator::make($data, [
    'toppings' => [
        'required',
        Rule::notIn(['sprinkles', 'cherries']),
    ],
]);

not_regex:_pattern_ The field under validation must not match the given regular expression.

Usage

'field' => 'not_regex:_pattern_'

Description

The field under validation must not match the given regular expression.

regex:_pattern_ The field under validation must match the given regular expression.

Usage

'field' => 'regex:_pattern_'

Description

The field under validation must match the given regular expression.

starts_with:_foo_,_bar_,... The field under validation must start with one of the given values.

Usage

'field' => 'starts_with:_foo_,_bar_,...'

Description

The field under validation must start with one of the given values.

string The field under validation must be a string. If you would like to allow the field to also be null, you should assign the nullable rule to the field.

Usage

'field' => 'string'

Description

The field under validation must be a string. If you would like to allow the field to also be null, you should assign the nullable rule to the field.

Examples

use Illuminate\Validation\Rule;

'title' => [
    'required',
    Rule::string()
        ->min(3)
        ->max(255)
        ->alphaDash(ascii: true),
],

ulid The field under validation must be a valid Universally Unique Lexicographically Sortable Identifier (ULID).

Usage

'field' => 'ulid'

Description

The field under validation must be a valid Universally Unique Lexicographically Sortable Identifier (ULID).

uppercase The field under validation must be uppercase.

Usage

'field' => 'uppercase'

Description

The field under validation must be uppercase.

url The field under validation must be a valid URL.

Usage

'field' => 'url'

Description

The field under validation must be a valid URL.

Examples

'url' => 'url:http,https',

'game' => 'url:minecraft,steam',

uuid The field under validation must be a valid RFC 9562 (version 1, 3, 4, 5, 6, 7, or 8) universally unique identifier (UUID).

Usage

'field' => 'uuid'

Description

The field under validation must be a valid RFC 9562 (version 1, 3, 4, 5, 6, 7, or 8) universally unique identifier (UUID).

Examples

'uuid' => 'uuid:4'

Numbers

decimal:_min_,_max_ The field under validation must be numeric and must contain the specified number of decimal places:

Usage

'field' => 'decimal:_min_,_max_'

Description

The field under validation must be numeric and must contain the specified number of decimal places:

Examples

// Must have exactly two decimal places (9.99)...
'price' => 'decimal:2'

// Must have between 2 and 4 decimal places...
'price' => 'decimal:2,4'

digits:_value_ The integer under validation must have an exact length of _value_.

Usage

'field' => 'digits:_value_'

Description

The integer under validation must have an exact length of _value_.

digits_between:_min_,_max_ The integer under validation must have a length between the given _min_ and _max_.

Usage

'field' => 'digits_between:_min_,_max_'

Description

The integer under validation must have a length between the given _min_ and _max_.

gt:_field_ The field under validation must be greater than the given _field_ or _value_. The two fields must be of the same type.

Usage

'field' => 'gt:_field_'

Description

The field under validation must be greater than the given _field_ or _value_. The two fields must be of the same type.

gte:_field_ The field under validation must be greater than or equal to the given _field_ or _value_. The two fields must be of the same type.

Usage

'field' => 'gte:_field_'

Description

The field under validation must be greater than or equal to the given _field_ or _value_. The two fields must be of the same type.

integer The field under validation must be an integer.

Usage

'field' => 'integer'

Description

The field under validation must be an integer.

Examples

'age' => 'integer:strict'

lt:_field_ The field under validation must be less than the given _field_. The two fields must be of the same type.

Usage

'field' => 'lt:_field_'

Description

The field under validation must be less than the given _field_. The two fields must be of the same type.

lte:_field_ The field under validation must be less than or equal to the given _field_. The two fields must be of the same type.

Usage

'field' => 'lte:_field_'

Description

The field under validation must be less than or equal to the given _field_. The two fields must be of the same type.

max_digits:_value_ The integer under validation must have a maximum length of _value_.

Usage

'field' => 'max_digits:_value_'

Description

The integer under validation must have a maximum length of _value_.

min_digits:_value_ The integer under validation must have a minimum length of _value_.

Usage

'field' => 'min_digits:_value_'

Description

The integer under validation must have a minimum length of _value_.

multiple_of:_value_ The field under validation must be a multiple of _value_.

Usage

'field' => 'multiple_of:_value_'

Description

The field under validation must be a multiple of _value_.

numeric The field under validation must be numeric.

Usage

'field' => 'numeric'

Description

The field under validation must be numeric.

Examples

'amount' => 'numeric:strict'

same:_field_ The given _field_ must match the field under validation.

Usage

'field' => 'same:_field_'

Description

The given _field_ must match the field under validation.

Arrays

array The field under validation must be a PHP array.

Usage

'field' => 'array'

Description

The field under validation must be a PHP array.

Examples

use Illuminate\Support\Facades\Validator;

$input = [
    'user' => [
        'name' => 'Taylor Otwell',
        'username' => 'taylorotwell',
        'admin' => true,
    ],
];

Validator::make($input, [
    'user' => 'array:name,username',
]);

contains:_foo_,_bar_,... The field under validation must be an array that contains all of the given parameter values. Since this rule often requires you to implode an array, the Rule::contains method may be used to fluently construct the rule:

Usage

'field' => 'contains:_foo_,_bar_,...'

Description

The field under validation must be an array that contains all of the given parameter values. Since this rule often requires you to implode an array, the Rule::contains method may be used to fluently construct the rule:

Examples

use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rule;

Validator::make($data, [
    'roles' => [
        'required',
        'array',
        Rule::contains(['admin', 'editor']),
    ],
]);

distinct When validating arrays, the field under validation must not have any duplicate values:

Usage

'field' => 'distinct'

Description

When validating arrays, the field under validation must not have any duplicate values:

Examples

'foo.*.id' => 'distinct'

'foo.*.id' => 'distinct:strict'

'foo.*.id' => 'distinct:ignore_case'

doesnt_contain:_foo_,_bar_,... The field under validation must be an array that does not contain any of the given parameter values. Since this rule often requires you to implode an array, the Rule::doesntContain method may be used to fluently construct the rule:

Usage

'field' => 'doesnt_contain:_foo_,_bar_,...'

Description

The field under validation must be an array that does not contain any of the given parameter values. Since this rule often requires you to implode an array, the Rule::doesntContain method may be used to fluently construct the rule:

Examples

use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rule;

Validator::make($data, [
    'roles' => [
        'required',
        'array',
        Rule::doesntContain(['admin', 'editor']),
    ],
]);

in_array:_anotherfield_.* The field under validation must exist in _anotherfield_'s values.

Usage

'field' => 'in_array:_anotherfield_.*'

Description

The field under validation must exist in _anotherfield_'s values.

in_array_keys:_value_.* The field under validation must be an array having at least one of the given _values_ as a key within the array:

Usage

'field' => 'in_array_keys:_value_.*'

Description

The field under validation must be an array having at least one of the given _values_ as a key within the array:

Examples

'config' => 'array|in_array_keys:timezone'

list The field under validation must be an array that is a list. An array is considered a list if its keys consist of consecutive numbers from 0 to count($array) - 1.

Usage

'field' => 'list'

Description

The field under validation must be an array that is a list. An array is considered a list if its keys consist of consecutive numbers from 0 to count($array) - 1.

min:_value_ The field under validation must have a minimum _value_. Strings, numerics, arrays, and files are evaluated in the same fashion as the size rule.

Usage

'field' => 'min:_value_'

Description

The field under validation must have a minimum _value_. Strings, numerics, arrays, and files are evaluated in the same fashion as the size rule.

Dates

after:_date_ The field under validation must be a value after a given date. The dates will be passed into the strtotime PHP function in order to be converted to a valid DateTime instance:

Usage

'field' => 'after:_date_'

Description

The field under validation must be a value after a given date. The dates will be passed into the strtotime PHP function in order to be converted to a valid DateTime instance:

Examples

'start_date' => 'required|date|after:tomorrow'

'finish_date' => 'required|date|after:start_date'

use Illuminate\Validation\Rule;

'start_date' => [
    'required',
    Rule::date()->after(today()->addDays(7)),
],

after_or_equal:_date_ The field under validation must be a value after or equal to the given date. For more information, see the after rule.

Usage

'field' => 'after_or_equal:_date_'

Description

The field under validation must be a value after or equal to the given date. For more information, see the after rule.

Examples

use Illuminate\Validation\Rule;

'start_date' => [
    'required',
    Rule::date()->afterOrEqual(today()->addDays(7)),
],

before:_date_ The field under validation must be a value preceding the given date. The dates will be passed into the PHP strtotime function in order to be converted into a valid DateTime instance.

Usage

'field' => 'before:_date_'

Description

The field under validation must be a value preceding the given date. The dates will be passed into the PHP strtotime function in order to be converted into a valid DateTime instance.

Examples

use Illuminate\Validation\Rule;

'start_date' => [
    'required',
    Rule::date()->before(today()->subDays(7)),
],

'start_date' => [
    'required',
    Rule::date()->beforeToday(),
],

before_or_equal:_date_ The field under validation must be a value preceding or equal to the given date. The dates will be passed into the PHP strtotime function in order to be converted into a valid DateTime instance.

Usage

'field' => 'before_or_equal:_date_'

Description

The field under validation must be a value preceding or equal to the given date. The dates will be passed into the PHP strtotime function in order to be converted into a valid DateTime instance.

Examples

use Illuminate\Validation\Rule;

'start_date' => [
    'required',
    Rule::date()->beforeOrEqual(today()->subDays(7)),
],

date The field under validation must be a valid, non-relative date according to the strtotime PHP function.

Usage

'field' => 'date'

Description

The field under validation must be a valid, non-relative date according to the strtotime PHP function.

date_equals:_date_ The field under validation must be equal to the given date. The dates will be passed into the PHP strtotime function in order to be converted into a valid DateTime instance.

Usage

'field' => 'date_equals:_date_'

Description

The field under validation must be equal to the given date. The dates will be passed into the PHP strtotime function in order to be converted into a valid DateTime instance.

date_format:_format_,... The field under validation must match one of the given _formats_. You should use either date or date_format when validating a field, not both.

Usage

'field' => 'date_format:_format_,...'

Description

The field under validation must match one of the given _formats_. You should use either date or date_format when validating a field, not both.

Examples

use Illuminate\Validation\Rule;

'start_date' => [
    'required',
    Rule::date()->format('Y-m-d'),
],

different:_field_ The field under validation must have a different value than _field_.

Usage

'field' => 'different:_field_'

Description

The field under validation must have a different value than _field_.

timezone The field under validation must be a valid timezone identifier according to the DateTimeZone::listIdentifiers method.

Usage

'field' => 'timezone'

Description

The field under validation must be a valid timezone identifier according to the DateTimeZone::listIdentifiers method.

Examples

'timezone' => 'required|timezone:all';

'timezone' => 'required|timezone:Africa';

'timezone' => 'required|timezone:per_country,US';

Files

between:_min_,_max_ The field under validation must have a size between the given _min_ and _max_ (inclusive). Strings, numerics, arrays, and files are evaluated in the same fashion as the size rule.

Usage

'field' => 'between:_min_,_max_'

Description

The field under validation must have a size between the given _min_ and _max_ (inclusive). Strings, numerics, arrays, and files are evaluated in the same fashion as the size rule.

dimensions The file under validation must be an image meeting the dimension constraints as specified by the rule's parameters:

Usage

'field' => 'dimensions'

Description

The file under validation must be an image meeting the dimension constraints as specified by the rule's parameters:

Examples

'avatar' => 'dimensions:min_width=100,min_height=200'

'avatar' => 'dimensions:ratio=3/2'

use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rule;

Validator::make($data, [
    'avatar' => [
        'required',
        Rule::dimensions()
            ->maxWidth(1000)
            ->maxHeight(500)
            ->ratio(3 / 2),
    ],
]);

encoding:*encoding_type* The field under validation must match the specified character encoding. This rule uses PHP's mb_check_encoding function to verify the encoding of the given file or string value.

Usage

'field' => 'encoding:*encoding_type*'

Description

The field under validation must match the specified character encoding. This rule uses PHP's mb_check_encoding function to verify the encoding of the given file or string value.

Examples

use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rules\File;

Validator::validate($input, [
    'attachment' => [
        'required',
        File::types(['csv'])
            ->encoding('utf-8'),
    ],
]);

extensions:_foo_,_bar_,... The file under validation must have a user-assigned extension corresponding to one of the listed extensions:

Usage

'field' => 'extensions:_foo_,_bar_,...'

Description

The file under validation must have a user-assigned extension corresponding to one of the listed extensions:

Examples

'photo' => ['required', 'extensions:jpg,png'],

file The field under validation must be a successfully uploaded file.

Usage

'field' => 'file'

Description

The field under validation must be a successfully uploaded file.

image The file under validation must be an image (jpg, jpeg, png, bmp, gif, or webp).

Usage

'field' => 'image'

Description

The file under validation must be an image (jpg, jpeg, png, bmp, gif, or webp).

max:_value_ The field under validation must be less than or equal to a maximum _value_. Strings, numerics, arrays, and files are evaluated in the same fashion as the size rule.

Usage

'field' => 'max:_value_'

Description

The field under validation must be less than or equal to a maximum _value_. Strings, numerics, arrays, and files are evaluated in the same fashion as the size rule.

mimes:_foo_,_bar_,... The file under validation must have a MIME type corresponding to one of the listed extensions:

Usage

'field' => 'mimes:_foo_,_bar_,...'

Description

The file under validation must have a MIME type corresponding to one of the listed extensions:

Examples

'photo' => 'mimes:jpg,bmp,png'

mimetypes:_text/plain_,... The file under validation must match one of the given MIME types:

Usage

'field' => 'mimetypes:_text/plain_,...'

Description

The file under validation must match one of the given MIME types:

Examples

'video' => 'mimetypes:video/avi,video/mpeg,video/quicktime',

'media' => 'mimetypes:image/*,video/*',

size:_value_ The field under validation must have a size matching the given _value_. For string data, _value_ corresponds to the number of characters.

Usage

'field' => 'size:_value_'

Description

The field under validation must have a size matching the given _value_. For string data, _value_ corresponds to the number of characters.

Examples

// Validate that a string is exactly 12 characters long...
'title' => 'size:12';

// Validate that a provided integer equals 10...
'seats' => 'integer|size:10';

// Validate that an array has exactly 5 elements...
'tags' => 'array|size:5';

// Validate that an uploaded file is exactly 512 kilobytes...
'image' => 'file|size:512';

Database

exists:_table_,_column_ The field under validation must exist in a given database table.

Usage

'field' => 'exists:_table_,_column_'

Description

The field under validation must exist in a given database table.

unique:_table_,_column_ The field under validation must not exist within the given database table.

Usage

'field' => 'unique:_table_,_column_'

Description

The field under validation must not exist within the given database table.

Examples

'email' => 'unique:App\Models\User,email_address'

'email' => 'unique:users,email_address'

'email' => 'unique:connection.users,email_address'

Utilities

anyOf The Rule::anyOf validation rule allows you to specify that the field under validation must satisfy any of the given validation rulesets. For example, the following rule will validate that the username field is either an email address or an alpha-numeric string (including dashes) that is at least 6 characters long:

Usage

'field' => 'anyOf'

Description

The Rule::anyOf validation rule allows you to specify that the field under validation must satisfy any of the given validation rulesets. For example, the following rule will validate that the username field is either an email address or an alpha-numeric string (including dashes) that is at least 6 characters long:

Examples

use Illuminate\Validation\Rule;

'username' => [
    'required',
    Rule::anyOf([
        ['string', 'email'],
        ['string', 'alpha_dash', 'min:6'],
    ]),
],

bail Stop running validation rules for the field after the first validation failure.

Usage

'field' => 'bail'

Description

Stop running validation rules for the field after the first validation failure.

Examples

if ($validator->stopOnFirstFailure()->fails()) {
    // ...
}

exclude The field under validation will be excluded from the request data returned by the validate and validated methods.

Usage

'field' => 'exclude'

Description

The field under validation will be excluded from the request data returned by the validate and validated methods.

exclude_if:_anotherfield_,_value_ The field under validation will be excluded from the request data returned by the validate and validated methods if the _anotherfield_ field is equal to _value_.

Usage

'field' => 'exclude_if:_anotherfield_,_value_'

Description

The field under validation will be excluded from the request data returned by the validate and validated methods if the _anotherfield_ field is equal to _value_.

Examples

use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rule;

Validator::make($request->all(), [
    'role_id' => Rule::excludeIf($request->user()->is_admin),
]);

Validator::make($request->all(), [
    'role_id' => Rule::excludeIf(fn () => $request->user()->is_admin),
]);

exclude_unless:_anotherfield_,_value_ The field under validation will be excluded from the request data returned by the validate and validated methods unless _anotherfield_'s field is equal to _value_. If _value_ is null (exclude_unless:name,null), the field under validation will be excluded unless the comparison field is null or the comparison field is missing from the request data.

Usage

'field' => 'exclude_unless:_anotherfield_,_value_'

Description

The field under validation will be excluded from the request data returned by the validate and validated methods unless _anotherfield_'s field is equal to _value_. If _value_ is null (exclude_unless:name,null), the field under validation will be excluded unless the comparison field is null or the comparison field is missing from the request data.

Examples

use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rule;

Validator::make($request->all(), [
    'role_id' => Rule::excludeUnless($request->user()->is_admin),
]);

Validator::make($request->all(), [
    'role_id' => Rule::excludeUnless(fn () => $request->user()->is_admin),
]);

exclude_with:_anotherfield_ The field under validation will be excluded from the request data returned by the validate and validated methods if the _anotherfield_ field is present.

Usage

'field' => 'exclude_with:_anotherfield_'

Description

The field under validation will be excluded from the request data returned by the validate and validated methods if the _anotherfield_ field is present.

exclude_without:_anotherfield_ The field under validation will be excluded from the request data returned by the validate and validated methods if the _anotherfield_ field is not present.

Usage

'field' => 'exclude_without:_anotherfield_'

Description

The field under validation will be excluded from the request data returned by the validate and validated methods if the _anotherfield_ field is not present.

filled The field under validation must not be empty when it is present.

Usage

'field' => 'filled'

Description

The field under validation must not be empty when it is present.

missing The field under validation must not be present in the input data.

Usage

'field' => 'missing'

Description

The field under validation must not be present in the input data.

missing_if:_anotherfield_,_value_,... The field under validation must not be present if the _anotherfield_ field is equal to any _value_.

Usage

'field' => 'missing_if:_anotherfield_,_value_,...'

Description

The field under validation must not be present if the _anotherfield_ field is equal to any _value_.

missing_unless:_anotherfield_,_value_ The field under validation must not be present unless the _anotherfield_ field is equal to any _value_.

Usage

'field' => 'missing_unless:_anotherfield_,_value_'

Description

The field under validation must not be present unless the _anotherfield_ field is equal to any _value_.

missing_with:_foo_,_bar_,... The field under validation must not be present _only if_ any of the other specified fields are present.

Usage

'field' => 'missing_with:_foo_,_bar_,...'

Description

The field under validation must not be present _only if_ any of the other specified fields are present.

missing_with_all:_foo_,_bar_,... The field under validation must not be present _only if_ all of the other specified fields are present.

Usage

'field' => 'missing_with_all:_foo_,_bar_,...'

Description

The field under validation must not be present _only if_ all of the other specified fields are present.

nullable The field under validation may be null.

Usage

'field' => 'nullable'

Description

The field under validation may be null.

present The field under validation must exist in the input data.

Usage

'field' => 'present'

Description

The field under validation must exist in the input data.

present_if:_anotherfield_,_value_,... The field under validation must be present if the _anotherfield_ field is equal to any _value_.

Usage

'field' => 'present_if:_anotherfield_,_value_,...'

Description

The field under validation must be present if the _anotherfield_ field is equal to any _value_.

present_unless:_anotherfield_,_value_ The field under validation must be present unless the _anotherfield_ field is equal to any _value_.

Usage

'field' => 'present_unless:_anotherfield_,_value_'

Description

The field under validation must be present unless the _anotherfield_ field is equal to any _value_.

present_with:_foo_,_bar_,... The field under validation must be present _only if_ any of the other specified fields are present.

Usage

'field' => 'present_with:_foo_,_bar_,...'

Description

The field under validation must be present _only if_ any of the other specified fields are present.

present_with_all:_foo_,_bar_,... The field under validation must be present _only if_ all of the other specified fields are present.

Usage

'field' => 'present_with_all:_foo_,_bar_,...'

Description

The field under validation must be present _only if_ all of the other specified fields are present.

prohibited The field under validation must be missing or empty. A field is "empty" if it meets one of the following criteria:

Usage

'field' => 'prohibited'

Description

The field under validation must be missing or empty. A field is "empty" if it meets one of the following criteria:

prohibited_if:_anotherfield_,_value_,... The field under validation must be missing or empty if the _anotherfield_ field is equal to any _value_. A field is "empty" if it meets one of the following criteria:

Usage

'field' => 'prohibited_if:_anotherfield_,_value_,...'

Description

The field under validation must be missing or empty if the _anotherfield_ field is equal to any _value_. A field is "empty" if it meets one of the following criteria:

Examples

use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rule;

Validator::make($request->all(), [
    'role_id' => Rule::prohibitedIf($request->user()->is_admin),
]);

Validator::make($request->all(), [
    'role_id' => Rule::prohibitedIf(fn () => $request->user()->is_admin),
]);

prohibited_if_accepted:_anotherfield_,... The field under validation must be missing or empty if the _anotherfield_ field is equal to "yes", "on", 1, "1", true, or "true".

Usage

'field' => 'prohibited_if_accepted:_anotherfield_,...'

Description

The field under validation must be missing or empty if the _anotherfield_ field is equal to "yes", "on", 1, "1", true, or "true".

prohibited_if_declined:_anotherfield_,... The field under validation must be missing or empty if the _anotherfield_ field is equal to "no", "off", 0, "0", false, or "false".

Usage

'field' => 'prohibited_if_declined:_anotherfield_,...'

Description

The field under validation must be missing or empty if the _anotherfield_ field is equal to "no", "off", 0, "0", false, or "false".

prohibited_unless:_anotherfield_,_value_,... The field under validation must be missing or empty unless the _anotherfield_ field is equal to any _value_. A field is "empty" if it meets one of the following criteria:

Usage

'field' => 'prohibited_unless:_anotherfield_,_value_,...'

Description

The field under validation must be missing or empty unless the _anotherfield_ field is equal to any _value_. A field is "empty" if it meets one of the following criteria:

Examples

use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rule;

Validator::make($request->all(), [
    'role_id' => Rule::prohibitedUnless($request->user()->is_admin),
]);

Validator::make($request->all(), [
    'role_id' => Rule::prohibitedUnless(fn () => $request->user()->is_admin),
]);

prohibits:_anotherfield_,... If the field under validation is not missing or empty, all fields in _anotherfield_ must be missing or empty. A field is "empty" if it meets one of the following criteria:

Usage

'field' => 'prohibits:_anotherfield_,...'

Description

If the field under validation is not missing or empty, all fields in _anotherfield_ must be missing or empty. A field is "empty" if it meets one of the following criteria:

required The field under validation must be present in the input data and not empty. A field is "empty" if it meets one of the following criteria:

Usage

'field' => 'required'

Description

The field under validation must be present in the input data and not empty. A field is "empty" if it meets one of the following criteria:

required_array_keys:_foo_,_bar_,... The field under validation must be an array and must contain at least the specified keys.

Usage

'field' => 'required_array_keys:_foo_,_bar_,...'

Description

The field under validation must be an array and must contain at least the specified keys.

required_if:_anotherfield_,_value_,... The field under validation must be present and not empty if the _anotherfield_ field is equal to any _value_.

Usage

'field' => 'required_if:_anotherfield_,_value_,...'

Description

The field under validation must be present and not empty if the _anotherfield_ field is equal to any _value_.

Examples

use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rule;

Validator::make($request->all(), [
    'role_id' => Rule::requiredIf($request->user()->is_admin),
]);

Validator::make($request->all(), [
    'role_id' => Rule::requiredIf(fn () => $request->user()->is_admin),
]);

required_if_accepted:_anotherfield_,... The field under validation must be present and not empty if the _anotherfield_ field is equal to "yes", "on", 1, "1", true, or "true".

Usage

'field' => 'required_if_accepted:_anotherfield_,...'

Description

The field under validation must be present and not empty if the _anotherfield_ field is equal to "yes", "on", 1, "1", true, or "true".

required_if_declined:_anotherfield_,... The field under validation must be present and not empty if the _anotherfield_ field is equal to "no", "off", 0, "0", false, or "false".

Usage

'field' => 'required_if_declined:_anotherfield_,...'

Description

The field under validation must be present and not empty if the _anotherfield_ field is equal to "no", "off", 0, "0", false, or "false".

required_unless:_anotherfield_,_value_,... The field under validation must be present and not empty unless the _anotherfield_ field is equal to any _value_. This also means _anotherfield_ must be present in the request data unless _value_ is null.

Usage

'field' => 'required_unless:_anotherfield_,_value_,...'

Description

The field under validation must be present and not empty unless the _anotherfield_ field is equal to any _value_. This also means _anotherfield_ must be present in the request data unless _value_ is null.

Examples

use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\Rule;

Validator::make($request->all(), [
    'role_id' => Rule::requiredUnless($request->user()->is_admin),
]);

Validator::make($request->all(), [
    'role_id' => Rule::requiredUnless(fn () => $request->user()->is_admin),
]);

required_with:_foo_,_bar_,... The field under validation must be present and not empty _only if_ any of the other specified fields are present and not empty.

Usage

'field' => 'required_with:_foo_,_bar_,...'

Description

The field under validation must be present and not empty _only if_ any of the other specified fields are present and not empty.

required_with_all:_foo_,_bar_,... The field under validation must be present and not empty _only if_ all of the other specified fields are present and not empty.

Usage

'field' => 'required_with_all:_foo_,_bar_,...'

Description

The field under validation must be present and not empty _only if_ all of the other specified fields are present and not empty.

required_without:_foo_,_bar_,... The field under validation must be present and not empty _only when_ any of the other specified fields are empty or not present.

Usage

'field' => 'required_without:_foo_,_bar_,...'

Description

The field under validation must be present and not empty _only when_ any of the other specified fields are empty or not present.

required_without_all:_foo_,_bar_,... The field under validation must be present and not empty _only when_ all of the other specified fields are empty or not present.

Usage

'field' => 'required_without_all:_foo_,_bar_,...'

Description

The field under validation must be present and not empty _only when_ all of the other specified fields are empty or not present.

Data sourced from the official Laravel documentation.