Validation Attributes

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

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

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

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;

Getting Started

As a Data Transfer Object

Validation

As a Resource

Advanced Usage

Resources

String Validation

Numeric Validation

Date Validation

Boolean & Acceptance

Array Validation

String Patterns

Email & URL

IP & Network

Database

File Validation

Field Relationships

Advanced

Special Rules

Comparison

Lists & Values

Prohibition

Exclusion

Build docs developers (and LLMs) love

Getting Started

As a Data Transfer Object

Validation

As a Resource

Advanced Usage

Resources

​String Validation

​Numeric Validation

​Date Validation

​Boolean & Acceptance

​Array Validation

​String Patterns

​Email & URL

​IP & Network

​Database

​File Validation

​Field Relationships

​Advanced

​Special Rules

​Comparison

​Lists & Values

​Prohibition

​Exclusion

Build docs developers (and LLMs) love

String Validation

Numeric Validation

Date Validation

Boolean & Acceptance

Array Validation

String Patterns

Email & URL

IP & Network

Database

File Validation

Field Relationships

Advanced

Special Rules

Comparison

Lists & Values

Prohibition

Exclusion