Validation Attributes

Complete reference of all validation attributes available in Laravel Data

Laravel Data provides validation attributes that correspond to Laravel’s validation rules. Use these attributes on data properties to automatically generate validation rules.

String Validation

Alpha

Docs

#[Alpha]
public string $name;

AlphaDash

Docs

#[AlphaDash]
public string $username;

AlphaNumeric

Docs

#[AlphaNumeric]
public string $code;

StringType

Docs

#[StringType]
public string $text;

Lowercase

Docs

#[Lowercase]
public string $email;

Uppercase

Docs

#[Uppercase]
public string $countryCode;

Numeric Validation

IntegerType

Docs

#[IntegerType]
public int $count;

Numeric

Docs

#[Numeric]
public string|int|float $amount;

Min

Docs

#[Min(20)]
public int $age;

Max

Docs

#[Max(100)]
public int $percentage;

Between

Docs

#[Between(3.14, 42)]
public float $value;

Digits

Docs

#[Digits(10)]
public int $phoneNumber;

DigitsBetween

Docs

#[DigitsBetween(2, 10)]
public int $code;

MinDigits

Docs

#[MinDigits(2)]
public int $value;

MaxDigits

Docs

#[MaxDigits(10)]
public int $value;

MultipleOf

Docs

#[MultipleOf(3)]
public int $quantity;

Date Validation

Date

Docs

#[Date]
public Carbon $date;

DateFormat

Docs

#[DateFormat('d-m-Y')]
public Carbon $date;

#[DateFormat(['Y-m-d', 'Y-m-d H:i:s'])]
public Carbon $date;

DateEquals

Docs

#[DateEquals('tomorrow')]
public Carbon $date;

#[DateEquals(Carbon::yesterday())]
public Carbon $date;

After

Docs

#[After('tomorrow')]
public Carbon $date;

#[After(Carbon::yesterday())]
public Carbon $date;

#[After(new FieldReference('start_date'))]
public Carbon $endDate;

AfterOrEqual

Docs

#[AfterOrEqual('tomorrow')]
public Carbon $date;

#[AfterOrEqual(new FieldReference('start_date'))]
public Carbon $endDate;

Before

Docs

#[Before('tomorrow')]
public Carbon $date;

#[Before(new FieldReference('end_date'))]
public Carbon $startDate;

BeforeOrEqual

Docs

#[BeforeOrEqual('tomorrow')]
public Carbon $date;

#[BeforeOrEqual(new FieldReference('end_date'))]
public Carbon $startDate;

Boolean & Acceptance

BooleanType

Docs

#[BooleanType]
public bool $active;

Accepted

Docs

#[Accepted]
public bool $termsAccepted;

AcceptedIf

Docs

#[AcceptedIf('other_field', 'equals_this')]
public bool $confirmation;

Declined

Docs

#[Declined]
public bool $optOut;

DeclinedIf

Docs

#[DeclinedIf('other_field', 'equals_this')]
public bool $optOut;

Array Validation

ArrayType

Docs

#[ArrayType]
public array $items;

#[ArrayType(['valid_key', 'other_valid_key'])]
public array $items;

#[ArrayType('valid_key', 'other_valid_key')]
public array $items;

ListType

Docs

#[ListType]
public array $items;

RequiredArrayKeys

Docs

#[RequiredArrayKeys('a')]
public array $items;

#[RequiredArrayKeys(['a', 'b'])]
public array $items;

#[RequiredArrayKeys('a', 'b')]
public array $items;

Distinct

Docs

#[Distinct]
public string $value;

#[Distinct(Distinct::Strict)]
public string $value;

#[Distinct(Distinct::IgnoreCase)]
public string $value;

String Patterns

StartsWith

Docs

#[StartsWith('a')]
public string $value;

#[StartsWith(['a', 'b'])]
public string $value;

#[StartsWith('a', 'b')]
public string $value;

EndsWith

Docs

#[EndsWith('a')]
public string $value;

#[EndsWith(['a', 'b'])]
public string $value;

DoesntStartWith

Docs

#[DoesntStartWith('a')]
public string $value;

#[DoesntStartWith(['a', 'b'])]
public string $value;

DoesntEndWith

Docs

#[DoesntEndWith('a')]
public string $value;

Regex

Docs

#[Regex('/^.+$/i')]
public string $value;

NotRegex

Docs

#[NotRegex('/^.+$/i')]
public string $value;

Email & URL

Email

Docs

#[Email]
public string $email;

#[Email(Email::RfcValidation)]
public string $email;

#[Email([Email::RfcValidation, Email::DnsCheckValidation])]
public string $email;

Url

Docs

#[Url]
public string $website;

#[Url(['http', 'https'])]
public string $website;

ActiveUrl

Docs

#[ActiveUrl]
public string $website;

IP & Network

IP

Docs

#[IP]
public string $ipAddress;

IPv4

Docs

#[IPv4]
public string $ipAddress;

IPv6

Docs

#[IPv6]
public string $ipAddress;

MacAddress

Docs

#[MacAddress]
public string $macAddress;

Database

Exists

Docs

#[Exists('users')]
public string $userId;

#[Exists(User::class)]
public string $userId;

#[Exists('users', 'email')]
public string $email;

#[Exists('users', 'email', connection: 'tenant')]
public string $email;

#[Exists('users', 'email', withoutTrashed: true)]
public string $email;

Unique

Docs

#[Unique('users')]
public string $email;

#[Unique(User::class)]
public string $email;

#[Unique('users', 'email')]
public string $email;

#[Unique('users', connection: 'tenant')]
public string $email;

#[Unique('users', withoutTrashed: true)]
public string $email;

#[Unique('users', ignore: 5)]
public string $email;

#[Unique('users', ignore: new AuthenticatedUserReference())]
public string $email;

#[Unique('posts', ignore: new RouteParameterReference('post'))]
public string $slug;

File Validation

File

Docs

#[File]
public UploadedFile $document;

Image

Docs

#[Image]
public UploadedFile $photo;

Mimes

Docs

#[Mimes('jpg')]
public UploadedFile $image;

#[Mimes(['jpg', 'png'])]
public UploadedFile $image;

#[Mimes('jpg', 'png')]
public UploadedFile $image;

MimeTypes

Docs

#[MimeTypes('video/quicktime')]
public UploadedFile $video;

#[MimeTypes(['video/quicktime', 'video/avi'])]
public UploadedFile $video;

Dimensions

Docs

#[Dimensions(ratio: 1.5)]
public UploadedFile $image;

#[Dimensions(maxWidth: 100, maxHeight: 100)]
public UploadedFile $image;

Field Relationships

Required

Docs

#[Required]
public string $name;

RequiredIf

Docs

#[RequiredIf('other_field', 'value')]
public ?string $conditional;

#[RequiredIf('other_field', ['value', 'another_value'])]
public ?string $conditional;

RequiredUnless

Docs

#[RequiredUnless('other_field', 'value')]
public ?string $conditional;

RequiredWith

Docs

#[RequiredWith('other_field')]
public ?string $conditional;

#[RequiredWith(['other_field', 'another_field'])]
public ?string $conditional;

RequiredWithAll

Docs

#[RequiredWithAll(['other_field', 'another_field'])]
public ?string $conditional;

RequiredWithout

Docs

#[RequiredWithout('other_field')]
public ?string $conditional;

RequiredWithoutAll

Docs

#[RequiredWithoutAll(['other_field', 'another_field'])]
public ?string $conditional;

Same

Docs

#[Same('other_field')]
public string $confirmation;

Different

Docs

#[Different('other_field')]
public string $value;

Confirmed

Docs

#[Confirmed]
public string $password;

Advanced

Enum

Docs

#[Enum(ChannelType::class)]
public string $channel;

#[Enum(ChannelType::class, only: [ChannelType::Email])]
public string $channel;

#[Enum(ChannelType::class, except: [ChannelType::Email])]
public string $channel;

Uuid

Docs

#[Uuid]
public string $id;

Ulid

Docs

#[Ulid]
public string $id;

Json

Docs

#[Json]
public string $metadata;

TimeZone

Docs

#[TimeZone]
public string $timezone;

Password

Docs

#[Password(min: 12, letters: true, mixedCase: true, numbers: false, symbols: false, uncompromised: true, uncompromisedThreshold: 0)]
public string $password;

CurrentPassword

Docs

#[CurrentPassword]
public string $currentPassword;

#[CurrentPassword('api')]
public string $currentPassword;

Special Rules

Rule

Define custom validation rules:

#[Rule('string|uuid')]
public string $id;

#[Rule(['string','uuid'])]
public string $id;

Nullable

Docs

#[Nullable]
public ?string $optionalField;

Sometimes

Docs

#[Sometimes]
public string $value;

Bail

Docs

#[Bail]
public string $value;

Filled

Docs

#[Filled]
public string $value;

Present

Docs

#[Present]
public string $value;

Comparison

GreaterThan

Docs

#[GreaterThan('other_field')]
public int $value;

GreaterThanOrEqualTo

Docs

#[GreaterThanOrEqualTo('other_field')]
public int $value;

LessThan

Docs

#[LessThan('other_field')]
public int $value;

LessThanOrEqualTo

Docs

#[LessThanOrEqualTo('other_field')]
public int $value;

Size

Docs

#[Size(10)]
public string $value;

Lists & Values

In

Docs

#[In([1, 2, 3, 'a', 'b'])]
public mixed $value;

#[In(1, 2, 3, 'a', 'b')]
public mixed $value;

NotIn

Docs

#[NotIn([1, 2, 3, 'a', 'b'])]
public mixed $value;

InArray

Docs

#[InArray('other_field')]
public string $value;

Prohibition

Prohibited

Docs

#[Prohibited]
public ?string $value;

ProhibitedIf

Docs

#[ProhibitedIf('other_field', 'has_value')]
public ?string $value;

#[ProhibitedIf('other_field', ['has_value', 'or_this_value'])]
public ?string $value;

ProhibitedUnless

Docs

#[ProhibitedUnless('other_field', 'has_value')]
public ?string $value;

Prohibits

Docs

#[Prohibits('other_field')]
public ?string $value;

#[Prohibits(['other_field', 'another_field'])]
public ?string $value;

Exclusion

At the moment the data is not yet excluded due to technical reasons. Version 4 should fix this.

ExcludeIf

Docs

#[ExcludeIf('other_field', 'has_value')]
public string $value;

ExcludeUnless

Docs

#[ExcludeUnless('other_field', 'has_value')]
public string $value;

ExcludeWith

Docs

#[ExcludeWith('other_field')]
public string $value;

ExcludeWithout

Docs

#[ExcludeWithout('other_field')]
public string $value;