trait ValidatesAttributes

Methods

bool
validateAccepted(string $attribute, mixed $value)

Validate that an attribute was "accepted".

bool
validateAcceptedIf(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute was "accepted" when another attribute has a given value.

bool
validateDeclined(string $attribute, mixed $value)

Validate that an attribute was "declined".

bool
validateDeclinedIf(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute was "declined" when another attribute has a given value.

bool
validateActiveUrl(string $attribute, mixed $value)

Validate that an attribute is an active URL.

array|false
getDnsRecords(string $hostname, int $type)

Get the DNS records for the given hostname.

bool
validateAscii(string $attribute, mixed $value)

Validate that an attribute is 7 bit ASCII.

bool
validateBail()

"Break" on first validation fail.

bool
validateBefore(string $attribute, mixed $value, mixed $parameters)

Validate the date is before a given date.

bool
validateBeforeOrEqual(string $attribute, mixed $value, mixed $parameters)

Validate the date is before or equal a given date.

bool
validateAfter(string $attribute, mixed $value, mixed $parameters)

Validate the date is after a given date.

bool
validateAfterOrEqual(string $attribute, mixed $value, mixed $parameters)

Validate the date is equal or after a given date.

bool
compareDates(string $attribute, mixed $value, array $parameters, string $operator)

Compare a given date against another using an operator.

string|null
getDateFormat(string $attribute)

Get the date format for an attribute if it has one.

int|null
getDateTimestamp(mixed $value)

Get the date timestamp.

bool
checkDateTimeOrder(string $format, string $first, string $second, string $operator)

Given two date/time strings, check that one is after the other.

getDateTimeWithOptionalFormat(string $format, string $value)

Get a DateTime instance from a string.

getDateTime(DateTimeInterface|string $value)

Get a DateTime instance from a string with no format.

bool
validateAlpha(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute contains only alphabetic characters.

bool
validateAlphaDash(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute contains only alpha-numeric characters, dashes, and underscores.

bool
validateAlphaNum(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute contains only alpha-numeric characters.

bool
validateArray(string $attribute, mixed $value, array $parameters = [])

Validate that an attribute is an array.

bool
validateList(string $attribute, mixed $value)

Validate that an attribute is a list.

bool
validateRequiredArrayKeys(string $attribute, mixed $value, array $parameters)

Validate that an array has all of the given keys.

bool
validateBetween(string $attribute, mixed $value, array $parameters)

Validate the size of an attribute is between a set of values.

bool
validateBoolean(string $attribute, mixed $value, array $parameters)

Validate that an attribute is a boolean.

bool
validateConfirmed(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute has a matching confirmation.

bool
validateContains(string $attribute, mixed $value, mixed $parameters)

Validate an attribute contains a list of values.

bool
validateDoesntContain(string $attribute, mixed $value, mixed $parameters)

Validate an attribute does not contain a list of values.

bool
validateCurrentPassword(string $attribute, mixed $value, mixed $parameters)

Validate that the password of the currently authenticated user matches the given value.

bool
validateDate(string $attribute, mixed $value)

Validate that an attribute is a valid date.

bool
isValidDate(mixed $value)

Determine if a value is a valid date.

bool
validateDateFormat(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute matches a date format.

bool
matchesDateFormat(mixed $value, string $format)

Determine if a value matches a specific date format.

bool
validateDateEquals(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is equal to another date.

bool
validateDecimal(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute has a given number of decimal places.

bool
validateDifferent(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is different from another attribute.

bool
validateDigits(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute has a given number of digits.

bool
validateDigitsBetween(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is between a given number of digits.

bool
validateDimensions(string $attribute, mixed $value, mixed $parameters)

Validate the dimensions of an image matches the given values.

bool
failsBasicDimensionChecks(array $parameters, int $width, int $height)

Test if the given width and height fail any conditions.

bool
failsRatioCheck(array $parameters, int $width, int $height)

Determine if the given parameters fail a dimension ratio check.

bool
validateDistinct(string $attribute, mixed $value, mixed $parameters)

Validate an attribute is unique among other values.

array
getDistinctValues(string $attribute)

Get the values to distinct between.

array
extractDistinctValues(string $attribute)

Extract the distinct values from the data.

bool
validateEmail(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is a valid e-mail address.

bool
isValidEmail(string $value)

Determine if a value is a valid email address using basic RFC validation.

bool
validateEncoding(string $attribute, mixed $value, array $parameters)

Validate that a value has a specific character encoding.

bool
validateExists(string $attribute, mixed $value, mixed $parameters)

Validate the existence of an attribute value in a database table.

int
getExistCount(mixed $connection, string $table, string $column, mixed $value, array $parameters)

Get the number of records that exist in storage.

bool
validateUnique(string $attribute, mixed $value, mixed $parameters)

Validate the uniqueness of an attribute value on a given database table.

array
getUniqueIds(string|null $idColumn, array $parameters)

Get the excluded ID column and value for the unique rule.

int|string|null
prepareUniqueId(mixed $id)

Prepare the given ID for querying.

array
getUniqueExtra(array $parameters)

Get the extra conditions for a unique rule.

array
parseTable(string $table)

Parse the connection / table for the unique / exists rules.

bool|string
getQueryColumn(array $parameters, string $attribute)

Get the column name for an exists / unique query.

string
guessColumnForQuery(string $attribute)

Guess the database column from the given attribute name.

array
getExtraConditions(array $segments)

Get the extra conditions for a unique / exists rule.

bool
validateExtensions(string $attribute, mixed $value, array $parameters)

Validate the extension of a file upload attribute is in a set of defined extensions.

bool
validateFile(string $attribute, mixed $value)

Validate the given value is a valid file.

bool
validateFilled(string $attribute, mixed $value)

Validate the given attribute is filled if it is present.

bool
validateGt(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is greater than another attribute.

bool
validateLt(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is less than another attribute.

bool
validateGte(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is greater than or equal another attribute.

bool
validateLte(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is less than or equal another attribute.

bool
validateLowercase(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is lowercase.

bool
validateUppercase(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is uppercase.

bool
validateHexColor(string $attribute, mixed $value)

Validate that an attribute is a valid HEX color.

bool
validateImage(string $attribute, mixed $value, array $parameters = [])

Validate the MIME type of a file is an image MIME type.

bool
validateIn(string $attribute, mixed $value, mixed $parameters)

Validate an attribute is contained within a list of values.

bool
validateInArray(string $attribute, mixed $value, mixed $parameters)

Validate that the values of an attribute are in another attribute.

bool
validateInArrayKeys(string $attribute, mixed $value, array $parameters)

Validate that an array contains at least one of the given keys.

bool
validateInteger(string $attribute, mixed $value, array $parameters = [])

Validate that an attribute is an integer.

bool
validateIp(string $attribute, mixed $value)

Validate that an attribute is a valid IP.

bool
validateIpv4(string $attribute, mixed $value)

Validate that an attribute is a valid IPv4.

bool
validateIpv6(string $attribute, mixed $value)

Validate that an attribute is a valid IPv6.

bool
isValidIp(string $value)

Determine if a value is a valid IP address (any version).

bool
isValidIpv4(string $value)

Determine if a value is a valid IPv4 address.

bool
isValidIpv6(string $value)

Determine if a value is a valid IPv6 address.

bool
validateMacAddress(string $attribute, mixed $value)

Validate that an attribute is a valid MAC address.

bool
validateJson(string $attribute, mixed $value)

Validate the attribute is a valid JSON string.

bool
validateMax(string $attribute, mixed $value, mixed $parameters)

Validate the size of an attribute is less than or equal to a maximum value.

bool
validateMaxDigits(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute has a maximum number of digits.

bool
validateMimes(string $attribute, mixed $value, mixed $parameters)

Validate the guessed extension of a file upload is in a set of file extensions.

bool
validateMimetypes(string $attribute, mixed $value, mixed $parameters)

Validate the MIME type of a file upload attribute is in a set of MIME types.

bool
shouldBlockPhpUpload(mixed $value, array $parameters)

Check if PHP uploads are explicitly allowed.

bool
validateMin(string $attribute, mixed $value, mixed $parameters)

Validate the size of an attribute is greater than or equal to a minimum value.

bool
validateMinDigits(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute has a minimum number of digits.

bool
validateMissing(mixed $attribute, mixed $value, array<int, int|string> $parameters)

Validate that an attribute is missing.

bool
validateMissingIf(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is missing when another attribute has a given value.

bool
validateMissingUnless(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is missing unless another attribute has a given value.

bool
validateMissingWith(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is missing when any given attribute is present.

bool
validateMissingWithAll(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is missing when all given attributes are present.

bool
validateMultipleOf(string $attribute, mixed $value, mixed $parameters)

Validate the value of an attribute is a multiple of a given value.

bool
isMultipleOf(mixed $value, mixed $divisor)

Determine if a value is an exact multiple of a divisor.

bool
validateNullable()

"Indicate" validation should pass if value is null.

bool
validateNotIn(string $attribute, mixed $value, mixed $parameters)

Validate an attribute is not contained within a list of values.

bool
validateNumeric(string $attribute, mixed $value, array $parameters = [])

Validate that an attribute is numeric.

bool
validatePresent(string $attribute, mixed $value)

Validate that an attribute exists even if not filled.

bool
validatePresentIf(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is present when another attribute has a given value.

bool
validatePresentUnless(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is present unless another attribute has a given value.

bool
validatePresentWith(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is present when any given attribute is present.

bool
validatePresentWithAll(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is present when all given attributes are present.

bool
validateRegex(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute passes a regular expression check.

bool
validateNotRegex(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute does not pass a regular expression check.

bool
validateRequired(string $attribute, mixed $value)

Validate that a required attribute exists.

bool
validateRequiredIf(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute exists when another attribute has a given value.

bool
validateRequiredIfAccepted(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute exists when another attribute was "accepted".

bool
validateRequiredIfDeclined(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute exists when another attribute was "declined".

bool
validateProhibited(string $attribute, mixed $value)

Validate that an attribute does not exist or is an empty string.

bool
validateProhibitedIf(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute does not exist when another attribute has a given value.

bool
validateProhibitedIfAccepted(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute does not exist when another attribute was "accepted".

bool
validateProhibitedIfDeclined(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute does not exist when another attribute was "declined".

bool
validateProhibitedUnless(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute does not exist unless another attribute has a given value.

bool
validateProhibits(string $attribute, mixed $value, mixed $parameters)

Validate that other attributes do not exist when this attribute exists.

bool
validateExclude()

Indicate that an attribute is excluded.

bool
validateExcludeIf(string $attribute, mixed $value, mixed $parameters)

Indicate that an attribute should be excluded when another attribute has a given value.

bool
validateExcludeUnless(string $attribute, mixed $value, mixed $parameters)

Indicate that an attribute should be excluded when another attribute does not have a given value.

bool
validateRequiredUnless(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute exists when another attribute does not have a given value.

bool
validateExcludeWith(string $attribute, mixed $value, mixed $parameters)

Indicate that an attribute should be excluded when another attribute presents.

bool
validateExcludeWithout(string $attribute, mixed $value, mixed $parameters)

Indicate that an attribute should be excluded when another attribute is missing.

array
parseDependentRuleParameters(array $parameters)

Prepare the values and the other value for validation.

bool
shouldConvertToBoolean(string $parameter)

Check if parameter should be converted to boolean.

array
convertValuesToBoolean(array $values)

Convert the given values to boolean if they are string "true" / "false".

array
convertValuesToNull(array $values)

Convert the given values to null if they are string "null".

bool
validateRequiredWith(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute exists when any other attribute exists.

bool
validateRequiredWithAll(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute exists when all other attributes exist.

bool
validateRequiredWithout(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute exists when another attribute does not.

bool
validateRequiredWithoutAll(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute exists when all other attributes do not.

bool
anyFailingRequired(array $attributes)

Determine if any of the given attributes fail the required test.

bool
allFailingRequired(array $attributes)

Determine if all of the given attributes fail the required test.

bool
validateSame(string $attribute, mixed $value, mixed $parameters)

Validate that two attributes match.

bool
validateSize(string $attribute, mixed $value, mixed $parameters)

Validate the size of an attribute.

bool
validateSometimes()

"Validate" optional attributes.

bool
validateStartsWith(string $attribute, mixed $value, mixed $parameters)

Validate the attribute starts with a given substring.

bool
validateDoesntStartWith(string $attribute, mixed $value, mixed $parameters)

Validate the attribute does not start with a given substring.

bool
validateEndsWith(string $attribute, mixed $value, mixed $parameters)

Validate the attribute ends with a given substring.

bool
validateDoesntEndWith(string $attribute, mixed $value, mixed $parameters)

Validate the attribute does not end with a given substring.

bool
validateString(string $attribute, mixed $value)

Validate that an attribute is a string.

bool
validateTimezone(string $attribute, mixed $value, array $parameters = [])

Validate that an attribute is a valid timezone.

bool
validateUrl(string $attribute, mixed $value, array $parameters = [])

Validate that an attribute is a valid URL.

bool
validateUlid(string $attribute, mixed $value)

Validate that an attribute is a valid ULID.

bool
isValidUlid(string $value)

Determine if a value is a valid ULID.

bool
validateUuid(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is a valid UUID.

bool
isValidUuid(string $value)

Determine if a value is a valid UUID (any version).

float|int|string
getSize(string $attribute, mixed $value)

Get the size of an attribute.

float|int|string
sizeOf(mixed $value, SizeMode $mode)

Compute a value's "size" given a pre-resolved mode.

bool
isValidFileInstance(mixed $value)

Check that the given value is a valid file instance.

bool
compare(mixed $first, mixed $second, string $operator)

Determine if a comparison passes between the given values.

array|null
parseNamedParameters(array $parameters)

Parse named parameters to $key => $value items.

void
requireParameterCount(int $count, array $parameters, string $rule)

Require a certain number of parameters to be present.

bool
isSameType(mixed $first, mixed $second)

Check if the parameters are of the same type.

void
shouldBeNumeric(string $attribute, string $rule)

Adds the existing rule to the numericRules array if the attribute's value is numeric.

mixed
trim(mixed $value)

Trim the value if it is a string.

mixed
ensureExponentWithinAllowedRange(string $attribute, mixed $value)

Ensure the exponent is within the allowed range.

Details

at line 46
bool validateAccepted(string $attribute, mixed $value)

Validate that an attribute was "accepted".

This validation rule implies the attribute is "required".

Parameters

string $attribute
mixed $value

Return Value

bool

at line 56
bool validateAcceptedIf(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute was "accepted" when another attribute has a given value.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 76
bool validateDeclined(string $attribute, mixed $value)

Validate that an attribute was "declined".

This validation rule implies the attribute is "required".

Parameters

string $attribute
mixed $value

Return Value

bool

at line 86
bool validateDeclinedIf(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute was "declined" when another attribute has a given value.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 104
bool validateActiveUrl(string $attribute, mixed $value)

Validate that an attribute is an active URL.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 128
protected array|false getDnsRecords(string $hostname, int $type)

Get the DNS records for the given hostname.

Parameters

string $hostname
int $type

Return Value

array|false

at line 136
bool validateAscii(string $attribute, mixed $value)

Validate that an attribute is 7 bit ASCII.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 146
bool validateBail()

"Break" on first validation fail.

Always returns true, just lets us put "bail" in rules.

Return Value

bool

at line 156
bool validateBefore(string $attribute, mixed $value, mixed $parameters)

Validate the date is before a given date.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 168
bool validateBeforeOrEqual(string $attribute, mixed $value, mixed $parameters)

Validate the date is before or equal a given date.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 180
bool validateAfter(string $attribute, mixed $value, mixed $parameters)

Validate the date is after a given date.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 192
bool validateAfterOrEqual(string $attribute, mixed $value, mixed $parameters)

Validate the date is equal or after a given date.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 204
protected bool compareDates(string $attribute, mixed $value, array $parameters, string $operator)

Compare a given date against another using an operator.

Parameters

string $attribute
mixed $value
array $parameters
string $operator

Return Value

bool

at line 224
protected string|null getDateFormat(string $attribute)

Get the date format for an attribute if it has one.

Parameters

string $attribute

Return Value

string|null

at line 236
protected int|null getDateTimestamp(mixed $value)

Get the date timestamp.

Parameters

mixed $value

Return Value

int|null

at line 246
protected bool checkDateTimeOrder(string $format, string $first, string $second, string $operator)

Given two date/time strings, check that one is after the other.

Parameters

string $format
string $first
string $second
string $operator

Return Value

bool

at line 266
protected DateTimeInterface|null getDateTimeWithOptionalFormat(string $format, string $value)

Get a DateTime instance from a string.

Parameters

string $format
string $value

Return Value

DateTimeInterface|null

at line 278
protected DateTimeInterface|null getDateTime(DateTimeInterface|string $value)

Get a DateTime instance from a string with no format.

Parameters

DateTimeInterface|string $value

Return Value

DateTimeInterface|null

at line 292
bool validateAlpha(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute contains only alphabetic characters.

If the 'ascii' option is passed, validate that an attribute contains only ascii alphabetic characters.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 306
bool validateAlphaDash(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute contains only alpha-numeric characters, dashes, and underscores.

If the 'ascii' option is passed, validate that an attribute contains only ascii alpha-numeric characters, dashes, and underscores.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 323
bool validateAlphaNum(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute contains only alpha-numeric characters.

If the 'ascii' option is passed, validate that an attribute contains only ascii alpha-numeric characters.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 341
bool validateArray(string $attribute, mixed $value, array $parameters = [])

Validate that an attribute is an array.

Parameters

string $attribute
mixed $value
array $parameters

Return Value

bool

at line 357
bool validateList(string $attribute, mixed $value)

Validate that an attribute is a list.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 367
bool validateRequiredArrayKeys(string $attribute, mixed $value, array $parameters)

Validate that an array has all of the given keys.

Parameters

string $attribute
mixed $value
array $parameters

Return Value

bool

at line 387
bool validateBetween(string $attribute, mixed $value, array $parameters)

Validate the size of an attribute is between a set of values.

Parameters

string $attribute
mixed $value
array $parameters

Return Value

bool

at line 400
bool validateBoolean(string $attribute, mixed $value, array $parameters)

Validate that an attribute is a boolean.

Parameters

string $attribute
mixed $value
array $parameters

Return Value

bool

at line 416
bool validateConfirmed(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute has a matching confirmation.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 426
bool validateContains(string $attribute, mixed $value, mixed $parameters)

Validate an attribute contains a list of values.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 446
bool validateDoesntContain(string $attribute, mixed $value, mixed $parameters)

Validate an attribute does not contain a list of values.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 466
protected bool validateCurrentPassword(string $attribute, mixed $value, mixed $parameters)

Validate that the password of the currently authenticated user matches the given value.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 483
bool validateDate(string $attribute, mixed $value)

Validate that an attribute is a valid date.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 495
protected bool isValidDate(mixed $value)

Determine if a value is a valid date.

Accepts DateTimeInterface instances, numeric timestamps, and string date representations. Validates via strtotime() and date_parse() + checkdate() to reject dates like February 30th.

Parameters

mixed $value

Return Value

bool

at line 519
bool validateDateFormat(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute matches a date format.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 542
protected bool matchesDateFormat(mixed $value, string $format)

Determine if a value matches a specific date format.

Creates a DateTime from the format and verifies round-trip formatting produces the same string. Catches ValueError for invalid format strings.

Parameters

mixed $value
string $format

Return Value

bool

at line 562
bool validateDateEquals(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is equal to another date.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 574
bool validateDecimal(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute has a given number of decimal places.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 603
bool validateDifferent(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is different from another attribute.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 625
bool validateDigits(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute has a given number of digits.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 640
bool validateDigitsBetween(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is between a given number of digits.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 655
bool validateDimensions(string $attribute, mixed $value, mixed $parameters)

Validate the dimensions of an image matches the given values.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 692
protected bool failsBasicDimensionChecks(array $parameters, int $width, int $height)

Test if the given width and height fail any conditions.

Parameters

array $parameters
int $width
int $height

Return Value

bool

at line 705
protected bool failsRatioCheck(array $parameters, int $width, int $height)

Determine if the given parameters fail a dimension ratio check.

Parameters

array $parameters
int $width
int $height

Return Value

bool

at line 760
bool validateDistinct(string $attribute, mixed $value, mixed $parameters)

Validate an attribute is unique among other values.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 774
protected array getDistinctValues(string $attribute)

Get the values to distinct between.

Parameters

string $attribute

Return Value

array

at line 793
protected array extractDistinctValues(string $attribute)

Extract the distinct values from the data.

Parameters

string $attribute

Return Value

array

at line 812
bool validateEmail(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is a valid e-mail address.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 844
protected bool isValidEmail(string $value)

Determine if a value is a valid email address using basic RFC validation.

Used by the inline check for the bare email rule token. The parameterized form (email:rfc,dns,spoof,filter,...) stays in validateEmail() and flows through the delegated path.

Parameters

string $value

Return Value

bool

at line 854
bool validateEncoding(string $attribute, mixed $value, array $parameters)

Validate that a value has a specific character encoding.

Parameters

string $attribute
mixed $value
array $parameters

Return Value

bool

at line 870
bool validateExists(string $attribute, mixed $value, mixed $parameters)

Validate the existence of an attribute value in a database table.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 901
protected int getExistCount(mixed $connection, string $table, string $column, mixed $value, array $parameters)

Get the number of records that exist in storage.

Parameters

mixed $connection
string $table
string $column
mixed $value
array $parameters

Return Value

int

at line 925
bool validateUnique(string $attribute, mixed $value, mixed $parameters)

Validate the uniqueness of an attribute value on a given database table.

If a database column is not specified, the attribute will be used.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 972
protected array getUniqueIds(string|null $idColumn, array $parameters)

Get the excluded ID column and value for the unique rule.

Parameters

string|null $idColumn
array $parameters

Return Value

array

at line 982
protected int|string|null prepareUniqueId(mixed $id)

Prepare the given ID for querying.

Parameters

mixed $id

Return Value

int|string|null

at line 1004
protected array getUniqueExtra(array $parameters)

Get the extra conditions for a unique rule.

Parameters

array $parameters

Return Value

array

at line 1016
array parseTable(string $table)

Parse the connection / table for the unique / exists rules.

Parameters

string $table

Return Value

array

at line 1039
bool|string getQueryColumn(array $parameters, string $attribute)

Get the column name for an exists / unique query.

Parameters

array $parameters
string $attribute

Return Value

bool|string

at line 1049
string guessColumnForQuery(string $attribute)

Guess the database column from the given attribute name.

Parameters

string $attribute

Return Value

string

at line 1063
protected array getExtraConditions(array $segments)

Get the extra conditions for a unique / exists rule.

Parameters

array $segments

Return Value

array

at line 1081
bool validateExtensions(string $attribute, mixed $value, array $parameters)

Validate the extension of a file upload attribute is in a set of defined extensions.

Parameters

string $attribute
mixed $value
array $parameters

Return Value

bool

at line 1097
bool validateFile(string $attribute, mixed $value)

Validate the given value is a valid file.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 1105
bool validateFilled(string $attribute, mixed $value)

Validate the given attribute is filled if it is present.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 1119
bool validateGt(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is greater than another attribute.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1151
bool validateLt(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is less than another attribute.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1183
bool validateGte(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is greater than or equal another attribute.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1215
bool validateLte(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is less than or equal another attribute.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1247
bool validateLowercase(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is lowercase.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1259
bool validateUppercase(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is uppercase.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1269
bool validateHexColor(string $attribute, mixed $value)

Validate that an attribute is a valid HEX color.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 1277
bool validateImage(string $attribute, mixed $value, array $parameters = [])

Validate the MIME type of a file is an image MIME type.

Parameters

string $attribute
mixed $value
array $parameters

Return Value

bool

at line 1293
bool validateIn(string $attribute, mixed $value, mixed $parameters)

Validate an attribute is contained within a list of values.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1313
bool validateInArray(string $attribute, mixed $value, mixed $parameters)

Validate that the values of an attribute are in another attribute.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1331
bool validateInArrayKeys(string $attribute, mixed $value, array $parameters)

Validate that an array contains at least one of the given keys.

Parameters

string $attribute
mixed $value
array $parameters

Return Value

bool

at line 1353
bool validateInteger(string $attribute, mixed $value, array $parameters = [])

Validate that an attribute is an integer.

Parameters

string $attribute
mixed $value
array $parameters

Return Value

bool

at line 1365
bool validateIp(string $attribute, mixed $value)

Validate that an attribute is a valid IP.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 1373
bool validateIpv4(string $attribute, mixed $value)

Validate that an attribute is a valid IPv4.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 1381
bool validateIpv6(string $attribute, mixed $value)

Validate that an attribute is a valid IPv6.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 1389
protected bool isValidIp(string $value)

Determine if a value is a valid IP address (any version).

Parameters

string $value

Return Value

bool

at line 1397
protected bool isValidIpv4(string $value)

Determine if a value is a valid IPv4 address.

Parameters

string $value

Return Value

bool

at line 1405
protected bool isValidIpv6(string $value)

Determine if a value is a valid IPv6 address.

Parameters

string $value

Return Value

bool

at line 1413
bool validateMacAddress(string $attribute, mixed $value)

Validate that an attribute is a valid MAC address.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 1421
bool validateJson(string $attribute, mixed $value)

Validate the attribute is a valid JSON string.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 1446
bool validateMax(string $attribute, mixed $value, mixed $parameters)

Validate the size of an attribute is less than or equal to a maximum value.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1462
bool validateMaxDigits(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute has a maximum number of digits.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1476
bool validateMimes(string $attribute, mixed $value, mixed $parameters)

Validate the guessed extension of a file upload is in a set of file extensions.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1498
bool validateMimetypes(string $attribute, mixed $value, mixed $parameters)

Validate the MIME type of a file upload attribute is in a set of MIME types.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1518
protected bool shouldBlockPhpUpload(mixed $value, array $parameters)

Check if PHP uploads are explicitly allowed.

Parameters

mixed $value
array $parameters

Return Value

bool

at line 1545
bool validateMin(string $attribute, mixed $value, mixed $parameters)

Validate the size of an attribute is greater than or equal to a minimum value.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1557
bool validateMinDigits(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute has a minimum number of digits.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1573
bool validateMissing(mixed $attribute, mixed $value, array<int, int|string> $parameters)

Validate that an attribute is missing.

Parameters

mixed $attribute
mixed $value
array<int, int|string> $parameters

Return Value

bool

at line 1583
bool validateMissingIf(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is missing when another attribute has a given value.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1601
bool validateMissingUnless(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is missing unless another attribute has a given value.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1619
bool validateMissingWith(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is missing when any given attribute is present.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1635
bool validateMissingWithAll(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is missing when all given attributes are present.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1651
bool validateMultipleOf(string $attribute, mixed $value, mixed $parameters)

Validate the value of an attribute is a multiple of a given value.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1667
protected bool isMultipleOf(mixed $value, mixed $divisor)

Determine if a value is an exact multiple of a divisor.

Uses BigDecimal remainder for arbitrary-precision comparison. Both value and divisor must be numeric; the exception translation wrapping stays in the caller (validateMultipleOf) for non-numeric cases, but the BigDecimal exception is thrown from here since that's where the math operation lives.

Parameters

mixed $value
mixed $divisor

Return Value

bool

at line 1700
bool validateNullable()

"Indicate" validation should pass if value is null.

Always returns true, just lets us put "nullable" in rules.

Return Value

bool

at line 1710
bool validateNotIn(string $attribute, mixed $value, mixed $parameters)

Validate an attribute is not contained within a list of values.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1718
bool validateNumeric(string $attribute, mixed $value, array $parameters = [])

Validate that an attribute is numeric.

Parameters

string $attribute
mixed $value
array $parameters

Return Value

bool

at line 1730
bool validatePresent(string $attribute, mixed $value)

Validate that an attribute exists even if not filled.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 1740
bool validatePresentIf(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is present when another attribute has a given value.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1758
bool validatePresentUnless(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is present unless another attribute has a given value.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1776
bool validatePresentWith(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is present when any given attribute is present.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1792
bool validatePresentWithAll(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is present when all given attributes are present.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1808
bool validateRegex(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute passes a regular expression check.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1824
bool validateNotRegex(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute does not pass a regular expression check.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1838
bool validateRequired(string $attribute, mixed $value)

Validate that a required attribute exists.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 1859
bool validateRequiredIf(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute exists when another attribute has a given value.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1879
bool validateRequiredIfAccepted(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute exists when another attribute was "accepted".

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1893
bool validateRequiredIfDeclined(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute exists when another attribute was "declined".

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1907
bool validateProhibited(string $attribute, mixed $value)

Validate that an attribute does not exist or is an empty string.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 1915
bool validateProhibitedIf(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute does not exist when another attribute has a given value.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1931
bool validateProhibitedIfAccepted(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute does not exist when another attribute was "accepted".

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1945
bool validateProhibitedIfDeclined(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute does not exist when another attribute was "declined".

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1959
bool validateProhibitedUnless(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute does not exist unless another attribute has a given value.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1975
bool validateProhibits(string $attribute, mixed $value, mixed $parameters)

Validate that other attributes do not exist when this attribute exists.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 1991
bool validateExclude()

Indicate that an attribute is excluded.

Return Value

bool

at line 1999
bool validateExcludeIf(string $attribute, mixed $value, mixed $parameters)

Indicate that an attribute should be excluded when another attribute has a given value.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 2015
bool validateExcludeUnless(string $attribute, mixed $value, mixed $parameters)

Indicate that an attribute should be excluded when another attribute does not have a given value.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 2027
bool validateRequiredUnless(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute exists when another attribute does not have a given value.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 2043
bool validateExcludeWith(string $attribute, mixed $value, mixed $parameters)

Indicate that an attribute should be excluded when another attribute presents.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 2057
bool validateExcludeWithout(string $attribute, mixed $value, mixed $parameters)

Indicate that an attribute should be excluded when another attribute is missing.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 2073
array parseDependentRuleParameters(array $parameters)

Prepare the values and the other value for validation.

Parameters

array $parameters

Return Value

array

at line 2093
protected bool shouldConvertToBoolean(string $parameter)

Check if parameter should be converted to boolean.

Parameters

string $parameter

Return Value

bool

at line 2101
protected array convertValuesToBoolean(array $values)

Convert the given values to boolean if they are string "true" / "false".

Parameters

array $values

Return Value

array

at line 2118
protected array convertValuesToNull(array $values)

Convert the given values to null if they are string "null".

Parameters

array $values

Return Value

array

at line 2128
bool validateRequiredWith(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute exists when any other attribute exists.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 2140
bool validateRequiredWithAll(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute exists when all other attributes exist.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 2152
bool validateRequiredWithout(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute exists when another attribute does not.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 2164
bool validateRequiredWithoutAll(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute exists when all other attributes do not.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 2176
protected bool anyFailingRequired(array $attributes)

Determine if any of the given attributes fail the required test.

Parameters

array $attributes

Return Value

bool

at line 2190
protected bool allFailingRequired(array $attributes)

Determine if all of the given attributes fail the required test.

Parameters

array $attributes

Return Value

bool

at line 2206
bool validateSame(string $attribute, mixed $value, mixed $parameters)

Validate that two attributes match.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 2220
bool validateSize(string $attribute, mixed $value, mixed $parameters)

Validate the size of an attribute.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 2232
bool validateSometimes()

"Validate" optional attributes.

Always returns true, just lets us put sometimes in rules.

Return Value

bool

at line 2242
bool validateStartsWith(string $attribute, mixed $value, mixed $parameters)

Validate the attribute starts with a given substring.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 2252
bool validateDoesntStartWith(string $attribute, mixed $value, mixed $parameters)

Validate the attribute does not start with a given substring.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 2262
bool validateEndsWith(string $attribute, mixed $value, mixed $parameters)

Validate the attribute ends with a given substring.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 2272
bool validateDoesntEndWith(string $attribute, mixed $value, mixed $parameters)

Validate the attribute does not end with a given substring.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 2280
bool validateString(string $attribute, mixed $value)

Validate that an attribute is a string.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 2288
bool validateTimezone(string $attribute, mixed $value, array $parameters = [])

Validate that an attribute is a valid timezone.

Parameters

string $attribute
mixed $value
array $parameters

Return Value

bool

at line 2299
bool validateUrl(string $attribute, mixed $value, array $parameters = [])

Validate that an attribute is a valid URL.

Parameters

string $attribute
mixed $value
array $parameters

Return Value

bool

at line 2307
bool validateUlid(string $attribute, mixed $value)

Validate that an attribute is a valid ULID.

Parameters

string $attribute
mixed $value

Return Value

bool

at line 2315
protected bool isValidUlid(string $value)

Determine if a value is a valid ULID.

Parameters

string $value

Return Value

bool

at line 2325
bool validateUuid(string $attribute, mixed $value, mixed $parameters)

Validate that an attribute is a valid UUID.

Parameters

string $attribute
mixed $value
mixed $parameters

Return Value

bool

at line 2347
protected bool isValidUuid(string $value)

Determine if a value is a valid UUID (any version).

Used by the inline check for the bare uuid rule token. The parameterized form (uuid:4, uuid:max) stays in validateUuid() and flows through the delegated path.

Parameters

string $value

Return Value

bool

at line 2355
protected float|int|string getSize(string $attribute, mixed $value)

Get the size of an attribute.

Parameters

string $attribute
mixed $value

Return Value

float|int|string

at line 2389
protected float|int|string sizeOf(mixed $value, SizeMode $mode)

Compute a value's "size" given a pre-resolved mode.

Mirrors getSize() but takes an explicit SizeMode instead of scanning sibling rules at runtime. Uses value-first dispatch: when mode is Numeric AND the value is numeric, returns the trimmed numeric value; otherwise falls through to array count / file size / string length.

This ordering is load-bearing: a mode-first version would throw NumberFormatException when a min:X|numeric rule runs before the numeric type check with a non-numeric value (e.g., 'abc'). getSize() falls back to string length in that situation; this helper must match.

Parameters

mixed $value
SizeMode $mode

Return Value

float|int|string

at line 2409
bool isValidFileInstance(mixed $value)

Check that the given value is a valid file instance.

Parameters

mixed $value

Return Value

bool

at line 2423
protected bool compare(mixed $first, mixed $second, string $operator)

Determine if a comparison passes between the given values.

Parameters

mixed $first
mixed $second
string $operator

Return Value

bool

Exceptions

InvalidArgumentException

at line 2440
array|null parseNamedParameters(array $parameters)

Parse named parameters to $key => $value items.

Parameters

array $parameters

Return Value

array|null

at line 2456
void requireParameterCount(int $count, array $parameters, string $rule)

Require a certain number of parameters to be present.

Parameters

int $count
array $parameters
string $rule

Return Value

void

Exceptions

InvalidArgumentException

at line 2466
protected bool isSameType(mixed $first, mixed $second)

Check if the parameters are of the same type.

Parameters

mixed $first
mixed $second

Return Value

bool

at line 2474
protected void shouldBeNumeric(string $attribute, string $rule)

Adds the existing rule to the numericRules array if the attribute's value is numeric.

Parameters

string $attribute
string $rule

Return Value

void

at line 2484
protected mixed trim(mixed $value)

Trim the value if it is a string.

Parameters

mixed $value

Return Value

mixed

at line 2492
protected mixed ensureExponentWithinAllowedRange(string $attribute, mixed $value)

Ensure the exponent is within the allowed range.

Parameters

string $attribute
mixed $value

Return Value

mixed