LegacyValidator
final class LegacyValidator extends Validator
Baseline validator using the pre-rewrite validateAttribute() loop AND the original O(n²) wildcard expansion.
Provides an accurate performance comparison against the full optimized path by reverting BOTH the execution model and the wildcard expansion.
Traits
Execute compiled AttributePlans against validation data.
Properties
| protected Container|null | $container | The container instance. |
from Validator |
| protected PresenceVerifierInterface|null | $presenceVerifier | The Presence Verifier implementation. |
from Validator |
| protected array | $failedRules | The failed validation rules. |
from Validator |
| protected array | $excludeAttributes | Attributes that should be excluded from the validated data. |
from Validator |
| protected MessageBag|null | $messages | The message bag instance. |
from Validator |
| protected array | $data | The data under validation. |
from Validator |
| protected array | $initialRules | The initial rules provided. |
from Validator |
| protected array | $rules | The rules to be applied to the data. |
from Validator |
| protected array|object|string|null | $currentRule | The current rule that is validating. |
from Validator |
| protected array | $implicitAttributes | The array of wildcard attributes with their asterisks expanded. |
from Validator |
| protected Closure|null | $implicitAttributesFormatter | The callback that should be used to format the attribute. |
from Validator |
| protected array | $distinctValues | The cached data for the "distinct" rule. |
from Validator |
| protected AttributePlan> | $compiledPlans | The compiled execution plans for the current passes() invocation. |
from Validator |
| protected PresenceVerifierInterface|null | $originalPresenceVerifier | The original presence verifier, saved during batched DB checks. |
from Validator |
| protected array | $after | All of the registered "after" callbacks. |
from Validator |
| array | $customMessages | The array of custom error messages. |
from Validator |
| array | $fallbackMessages | The array of fallback error messages. |
from Validator |
| array | $customAttributes | The array of custom attribute names. |
from Validator |
| array | $customValues | The array of custom displayable values. |
from Validator |
| protected bool | $stopOnFirstFailure | Indicates if the validator should stop on the first rule failure. |
from Validator |
| bool | $excludeUnvalidatedArrayKeys | Indicates that unvalidated array keys should be excluded, even if the parent array was validated. |
from Validator |
| array | $extensions | All of the custom validator extensions. |
from Validator |
| array | $replacers | All of the custom replacer extensions. |
from Validator |
| protected string[] | $fileRules | The validation rules that may be applied to files. |
from Validator |
| protected string[] | $implicitRules | The validation rules that imply the field is required. |
from Validator |
| protected string[] | $dependentRules | The validation rules which depend on other fields as parameters. |
from Validator |
| protected string[] | $excludeRules | The validation rules that can exclude an attribute. |
from Validator |
| protected string[] | $sizeRules | The size related validation rules. |
from Validator |
| protected string[] | $numericRules | The numeric related validation rules. |
from Validator |
| protected string[] | $defaultNumericRules | The default numeric related validation rules. |
from Validator |
| static protected bool | $fakeDnsLookups | Indicates if DNS lookups performed by validation rules should be faked to always succeed. |
from Validator |
| static protected null|array<string, true> | $encodingNames | The lowercase names of the encodings supported by mbstring. |
from Validator |
| static protected null|array<string, true> | $timezoneIdentifiers | The identifiers of every timezone. |
from Validator |
| protected ValidationException>|ValidationException | $exception | The exception to throw upon failure. |
from Validator |
| protected Closure|null | $ensureExponentWithinAllowedRangeUsing | The custom callback to determine if an exponent is within allowed range. |
from Validator |
Methods
Replace all place-holders for the accepted_if rule.
Replace all place-holders for the declined_if rule.
Replace all place-holders for the between rule.
Replace all place-holders for the date_format rule.
Replace all place-holders for the decimal rule.
Replace all place-holders for the different rule.
Replace all place-holders for the digits rule.
Replace all place-holders for the digits (between) rule.
Replace all place-holders for the encoding rule.
Replace all place-holders for the extensions rule.
Replace all place-holders for the min rule.
Replace all place-holders for the min digits rule.
Replace all place-holders for the max rule.
Replace all place-holders for the max digits rule.
Replace all place-holders for the missing_if rule.
Replace all place-holders for the missing_unless rule.
Replace all place-holders for the missing_with rule.
Replace all place-holders for the missing_with_all rule.
Replace all place-holders for the multiple_of rule.
Replace all place-holders for the in rule.
Replace all place-holders for the not_in rule.
Replace all place-holders for the in_array rule.
Replace all place-holders for the in_array_keys rule.
Replace all place-holders for the array_keys rule.
Replace all place-holders for the required_array_keys rule.
Replace all place-holders for the mimetypes rule.
Replace all place-holders for the mimes rule.
Replace all place-holders for the present_if rule.
Replace all place-holders for the present_unless rule.
Replace all place-holders for the present_with rule.
Replace all place-holders for the present_with_all rule.
Replace all place-holders for the required_with rule.
Replace all place-holders for the required_with_all rule.
Replace all place-holders for the required_without rule.
Replace all place-holders for the required_without_all rule.
Replace all place-holders for the size rule.
Replace all place-holders for the gt rule.
Replace all place-holders for the lt rule.
Replace all place-holders for the gte rule.
Replace all place-holders for the lte rule.
Replace all place-holders for the required_if rule.
Replace all place-holders for the required_if_accepted rule.
Replace all place-holders for the required_if_declined rule.
Replace all place-holders for the required_unless rule.
Replace all place-holders for the prohibited_if rule.
Replace all place-holders for the prohibited_if_accepted rule.
Replace all place-holders for the prohibited_if_declined rule.
Replace all place-holders for the prohibited_unless rule.
Replace all place-holders for the prohibited_with rule.
Replace all place-holders for the same rule.
Replace all place-holders for the before rule.
Replace all place-holders for the before_or_equal rule.
Replace all place-holders for the after rule.
Replace all place-holders for the after_or_equal rule.
Replace all place-holders for the date_equals rule.
Replace all place-holders for the dimensions rule.
Replace all place-holders for the ends_with rule.
Replace all place-holders for the doesnt_end_with rule.
Replace all place-holders for the starts_with rule.
Replace all place-holders for the doesnt_start_with rule.
Replace all place-holders for the doesnt_contain rule.
Get the validation message for an attribute and rule.
Get the proper inline error message for standard and size rules.
Get the inline message for a rule if it exists.
Get the custom error message from the translator.
Check the given messages for a wildcard key.
Build a wildcard message pattern that preserves literal path segments.
Get the proper error message for an attribute and size rule.
Get the data type of the given attribute.
Replace all error message place-holders with actual values.
Get the displayable name of the attribute.
Get the given attribute from the attribute translations.
Get the custom name for an attribute if it exists in the given array.
Replace the :attribute placeholder in the given message.
Replace the :index placeholder in the given message.
Replace the :position placeholder in the given message.
Replace the :ordinal-position placeholder in the given message.
Replace the :index or :position placeholder in the given message.
Get the word for a index or position segment.
Replace the :input placeholder in the given message.
Get the displayable name of the value.
Transform an array of attributes to their displayable form.
Call a custom validator message replacer.
Call a class based validator message replacer.
Validate that an attribute was "accepted".
Validate that an attribute was "accepted" when another attribute has a given value.
Validate that an attribute was "declined".
Validate that an attribute was "declined" when another attribute has a given value.
Validate that an attribute is an active URL.
Get the DNS records for the given hostname.
Validate that an attribute is 7 bit ASCII.
Validate that an attribute is a valid Base64 string.
Validate the date is before a given date.
Validate the date is before or equal a given date.
Validate the date is after a given date.
Validate the date is equal or after a given date.
Compare a given date against another using an operator.
Get the date format for an attribute if it has one.
Compare a date value with a literal or referenced field using the given format.
Get a DateTime instance from a supported value using the given format.
Get a DateTime instance from a string with no format.
Validate that an attribute contains only alphabetic characters.
Validate that an attribute contains only alpha-numeric characters, dashes, and underscores.
Validate that an attribute contains only alpha-numeric characters.
Validate that an attribute is an array.
Get the accepted literal and encoded array keys.
Validate that an array does not contain any keys other than the given keys.
Validate that an attribute is a list.
Validate that an array has all of the given keys.
Validate the size of an attribute is between a set of values.
Validate that an attribute is a boolean.
Validate that an attribute has a matching confirmation.
Validate an attribute contains a list of values.
Validate an attribute does not contain a list of values.
Validate that the password of the currently authenticated user matches the given value.
Validate that an attribute is a valid date.
Validate that an attribute matches a date format.
Determine if a value matches a specific date format.
Validate that an attribute is equal to another date.
Validate that an attribute has a given number of decimal places.
Validate that an attribute is different from another attribute.
Validate that an attribute has a given number of digits.
Validate that an attribute is between a given number of digits.
Validate the dimensions of an image matches the given values.
Test if the given width and height fail any conditions.
Determine if the given parameters fail a dimension ratio check.
Validate an attribute is unique among other values.
Get the values to distinct between.
Extract the distinct values from the data.
Validate that an attribute is a valid e-mail address.
Determine if a value is a valid email address using basic RFC validation.
Validate the encoding of an attribute.
Validate the existence of an attribute value in a database table.
Get the number of records that exist in storage.
Validate the uniqueness of an attribute value on a given database table.
Get the excluded ID column and value for the unique rule.
Prepare the given ID for querying.
Get the extra conditions for a unique rule.
Parse the connection / table for the unique / exists rules.
Get the column name for an exists / unique query.
Guess the database column from the given attribute name.
Get the extra conditions for a unique / exists rule.
Validate the extension of a file upload attribute is in a set of defined extensions.
Validate the given value is a valid file.
Validate the given attribute is filled if it is present.
Validate that an attribute is greater than another attribute.
Validate that an attribute is less than another attribute.
Validate that an attribute is greater than or equal another attribute.
Validate that an attribute is less than or equal another attribute.
Validate that an attribute is lowercase.
Validate that an attribute is uppercase.
Validate that an attribute is a valid HEX color.
Validate the MIME type of a file is an image MIME type.
Validate an attribute is contained within a list of values.
Validate that the values of an attribute are in another attribute.
Validate that an array contains at least one of the given keys.
Validate that an attribute is an integer.
Validate that an attribute is a valid IP.
Validate that an attribute is a valid IPv4.
Validate that an attribute is a valid IPv6.
Determine if a value is a valid IP address (any version).
Determine if a value is a valid IPv4 address.
Determine if a value is a valid IPv6 address.
Validate that an attribute is a valid MAC address.
Validate the attribute is a valid JSON string.
Validate the size of an attribute is less than or equal to a maximum value.
Validate that an attribute has a maximum number of digits.
Validate the guessed extension of a file upload is in a set of file extensions.
Validate the MIME type of a file upload attribute is in a set of MIME types.
Check if PHP uploads are explicitly allowed.
Validate the size of an attribute is greater than or equal to a minimum value.
Validate that an attribute has a minimum number of digits.
Validate that an attribute is missing.
Validate that an attribute is missing when another attribute has a given value.
Validate that an attribute is missing unless another attribute has a given value.
Validate that an attribute is missing when any given attribute is present.
Validate that an attribute is missing when all given attributes are present.
Validate the value of an attribute is a multiple of a given value.
Determine if a value is an exact multiple of a divisor.
"Indicate" validation should pass if value is null.
Validate an attribute is not contained within a list of values.
Validate that an attribute is numeric.
Validate that an attribute exists even if not filled.
Validate that an attribute is present when another attribute has a given value.
Validate that an attribute is present unless another attribute has a given value.
Validate that an attribute is present when any given attribute is present.
Validate that an attribute is present when all given attributes are present.
Validate that an attribute passes a regular expression check.
Validate that an attribute does not pass a regular expression check.
Validate that a required attribute exists.
Validate that an attribute exists when another attribute has a given value.
Validate that an attribute exists when another attribute was "accepted".
Validate that an attribute exists when another attribute was "declined".
Validate that an attribute does not exist or is an empty string.
Validate that an attribute does not exist when another attribute has a given value.
Validate that an attribute does not exist when another attribute was "accepted".
Validate that an attribute does not exist when another attribute was "declined".
Validate that an attribute does not exist unless another attribute has a given value.
Validate that other attributes do not exist when this attribute exists.
Indicate that an attribute should be excluded when another attribute has a given value.
Indicate that an attribute should be excluded when another attribute does not have a given value.
Validate that an attribute exists when another attribute does not have a given value.
Indicate that an attribute should be excluded when another attribute presents.
Indicate that an attribute should be excluded when another attribute is missing.
Prepare the values and the other value for validation.
Check if parameter should be converted to boolean.
Convert the given values to boolean if they are string "true" / "false".
Convert the given values to null if they are string "null".
Validate that an attribute exists when any other attribute exists.
Validate that an attribute exists when all other attributes exist.
Validate that an attribute exists when another attribute does not.
Validate that an attribute exists when all other attributes do not.
Determine if any of the given attributes fail the required test.
Determine if all of the given attributes fail the required test.
Validate that two attributes match.
Validate the size of an attribute.
Validate the attribute starts with a given substring.
Validate the attribute does not start with a given substring.
Validate the attribute ends with a given substring.
Validate the attribute does not end with a given substring.
Validate that an attribute is a string.
Validate that an attribute is a valid timezone.
Validate that an attribute is a valid URL.
Validate that an attribute is a valid ULID.
Validate that an attribute is a valid UUID.
Determine if a value is a valid UUID (any version).
Get the size of an attribute.
Compute the validation size from numeric semantics and runtime value shape.
Check that the given value is a valid file instance.
Determine if a comparison passes between the given values.
Parse named parameters to $key => $value items.
Require a certain number of parameters to be present.
Check if the parameters are of the same type.
Adds the existing rule to the numericRules array if the attribute's value is numeric.
Ensure the exponent is within the allowed range.
Execute all compiled plans against the validation data.
Execute all-delegated plans for a Validator subclass.
Determine if a non-implicit check should be skipped.
Determine if an invalid upload should fail before rule execution.
Determine if an inline check is safe to repeat during presence preflight.
Execute an inline check against a value.
Create a new Validator instance.
Replace the placeholders in the given string.
Replace each field parameter key placeholder.
Determine if the data passes the validation rules using the legacy path.
Determine if any compiled check can mutate this validator's data.
Batch safe database-presence candidates by query shape.
Execute the callback if the data passes the validation rules.
Execute the callback if the data fails the validation rules.
Determine if the attribute should be excluded.
Get a validated input container for the validated input.
Validate a given attribute against a rule.
Determine if the given rule depends on other fields.
Get the explicit keys from an attribute flattened with dot notation.
Replace each escaped field parameter separator with its placeholder.
Replace each field parameter which has asterisks with the given keys.
Determine if the attribute is validatable.
Determine if the field is present, or the rule implies required.
Determine if a given rule implies the attribute is required.
Determine if the attribute passes any optional check.
Determine if the attribute fails the nullable check.
Determine if it's a necessary presence validation.
Validate an attribute using a custom rule object.
Check if we should stop further validations on a given attribute.
Add a failed rule and error message to the collection.
Add the given attribute to the list of excluded attributes.
Generate an array of all attributes that have messages.
Determine if the given attribute has a rule in the given set.
Get a rule and its parameters for a given attribute.
Get the validation rules with key placeholders removed.
Retain the selected rules from the graph prepared for the current data.
Override addRules to use the legacy O(n²) wildcard expansion parser.
Add conditions to a given field based on a Closure.
Instruct the validator to stop validating after the first rule failure.
Register an array of custom validator extensions.
Register an array of custom implicit validator extensions.
Register an array of custom dependent validator extensions.
Register a custom implicit validator extension.
Register a custom dependent validator extension.
Register an array of custom validator message replacers.
Set the custom messages for the validator.
Set the custom attributes on the validator.
Add custom attributes to the validator.
Set the callback that used to format an implicit attribute.
Add the custom values for the validator.
Set the fallback messages for the validator.
Get the Presence Verifier implementation.
Set the Presence Verifier implementation.
Get the exception to throw upon failed validation.
Ensure exponents are within range using the given callback.
Call a custom validator extension.
Call a class based validator extension.
Encode the attribute with the placeholder hash.
Decode an attribute with a placeholder hash.
Fake the DNS lookups performed by validation rules so they always succeed.
Details
in
ReplacesAttributes at line 17
protected string
replaceAcceptedIf(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the accepted_if rule.
in
ReplacesAttributes at line 31
protected string
replaceDeclinedIf(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the declined_if rule.
in
ReplacesAttributes at line 41
protected string
replaceBetween(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the between rule.
in
ReplacesAttributes at line 51
protected string
replaceDateFormat(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the date_format rule.
in
ReplacesAttributes at line 61
protected string
replaceDecimal(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the decimal rule.
in
ReplacesAttributes at line 77
protected string
replaceDifferent(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the different rule.
in
ReplacesAttributes at line 87
protected string
replaceDigits(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the digits rule.
in
ReplacesAttributes at line 97
protected string
replaceDigitsBetween(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the digits (between) rule.
in
ReplacesAttributes at line 107
protected string
replaceEncoding(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the encoding rule.
in
ReplacesAttributes at line 117
protected string
replaceExtensions(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the extensions rule.
in
ReplacesAttributes at line 127
protected string
replaceMin(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the min rule.
in
ReplacesAttributes at line 137
protected string
replaceMinDigits(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the min digits rule.
in
ReplacesAttributes at line 147
protected string
replaceMax(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the max rule.
in
ReplacesAttributes at line 157
protected string
replaceMaxDigits(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the max digits rule.
in
ReplacesAttributes at line 167
protected string
replaceMissingIf(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the missing_if rule.
in
ReplacesAttributes at line 177
protected string
replaceMissingUnless(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the missing_unless rule.
in
ReplacesAttributes at line 190
protected string
replaceMissingWith(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the missing_with rule.
in
ReplacesAttributes at line 208
protected string
replaceMissingWithAll(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the missing_with_all rule.
in
ReplacesAttributes at line 218
protected string
replaceMultipleOf(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the multiple_of rule.
in
ReplacesAttributes at line 228
protected string
replaceIn(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the in rule.
in
ReplacesAttributes at line 250
protected string
replaceNotIn(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the not_in rule.
in
ReplacesAttributes at line 260
protected string
replaceInArray(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the in_array rule.
in
ReplacesAttributes at line 272
protected string
replaceInArrayKeys(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the in_array_keys rule.
in
ReplacesAttributes at line 282
protected string
replaceArrayKeys(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the array_keys rule.
in
ReplacesAttributes at line 305
protected string
replaceRequiredArrayKeys(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the required_array_keys rule.
in
ReplacesAttributes at line 315
protected string
replaceMimetypes(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the mimetypes rule.
in
ReplacesAttributes at line 325
protected string
replaceMimes(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the mimes rule.
in
ReplacesAttributes at line 335
protected string
replacePresentIf(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the present_if rule.
in
ReplacesAttributes at line 345
protected string
replacePresentUnless(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the present_unless rule.
in
ReplacesAttributes at line 355
protected string
replacePresentWith(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the present_with rule.
in
ReplacesAttributes at line 373
protected string
replacePresentWithAll(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the present_with_all rule.
in
ReplacesAttributes at line 383
protected string
replaceRequiredWith(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the required_with rule.
in
ReplacesAttributes at line 401
protected string
replaceRequiredWithAll(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the required_with_all rule.
in
ReplacesAttributes at line 411
protected string
replaceRequiredWithout(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the required_without rule.
in
ReplacesAttributes at line 421
protected string
replaceRequiredWithoutAll(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the required_without_all rule.
in
ReplacesAttributes at line 431
protected string
replaceSize(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the size rule.
in
ReplacesAttributes at line 441
protected string
replaceGt(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the gt rule.
in
ReplacesAttributes at line 455
protected string
replaceLt(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the lt rule.
in
ReplacesAttributes at line 465
protected string
replaceGte(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the gte rule.
in
ReplacesAttributes at line 475
protected string
replaceLte(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the lte rule.
in
ReplacesAttributes at line 485
protected string
replaceRequiredIf(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the required_if rule.
in
ReplacesAttributes at line 495
protected string
replaceRequiredIfAccepted(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the required_if_accepted rule.
in
ReplacesAttributes at line 507
protected string
replaceRequiredIfDeclined(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the required_if_declined rule.
in
ReplacesAttributes at line 517
protected string
replaceRequiredUnless(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the required_unless rule.
in
ReplacesAttributes at line 546
protected string
replaceProhibitedIf(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the prohibited_if rule.
in
ReplacesAttributes at line 556
protected string
replaceProhibitedIfAccepted(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the prohibited_if_accepted rule.
in
ReplacesAttributes at line 566
protected string
replaceProhibitedIfDeclined(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the prohibited_if_declined rule.
in
ReplacesAttributes at line 576
protected string
replaceProhibitedUnless(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the prohibited_unless rule.
in
ReplacesAttributes at line 586
protected string
replaceProhibits(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the prohibited_with rule.
in
ReplacesAttributes at line 604
protected string
replaceSame(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the same rule.
in
ReplacesAttributes at line 616
protected string
replaceBefore(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the before rule.
in
ReplacesAttributes at line 630
protected string
replaceBeforeOrEqual(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the before_or_equal rule.
in
ReplacesAttributes at line 640
protected string
replaceAfter(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the after rule.
in
ReplacesAttributes at line 650
protected string
replaceAfterOrEqual(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the after_or_equal rule.
in
ReplacesAttributes at line 660
protected string
replaceDateEquals(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the date_equals rule.
in
ReplacesAttributes at line 670
protected string
replaceDimensions(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the dimensions rule.
in
ReplacesAttributes at line 688
protected string
replaceEndsWith(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the ends_with rule.
in
ReplacesAttributes at line 698
protected string
replaceDoesntEndWith(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the doesnt_end_with rule.
in
ReplacesAttributes at line 708
protected string
replaceStartsWith(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the starts_with rule.
in
ReplacesAttributes at line 718
protected string
replaceDoesntStartWith(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the doesnt_start_with rule.
in
ReplacesAttributes at line 728
protected string
replaceDoesntContain(string $message, string $attribute, string $rule, array $parameters)
Replace all place-holders for the doesnt_contain rule.
in
FormatsMessages at line 21
protected string
getMessage(string $attribute, string $rule)
Get the validation message for an attribute and rule.
in
FormatsMessages at line 77
protected string|null
getInlineMessage(string $attribute, string $rule)
Get the proper inline error message for standard and size rules.
in
FormatsMessages at line 93
protected array|string|null
getFromLocalArray(string $attribute, string $lowerRule, array|null $source = null)
Get the inline message for a rule if it exists.
in
FormatsMessages at line 150
protected string
getCustomMessageFromTranslator(array|string $keys)
Get the custom error message from the translator.
in
FormatsMessages at line 183
protected string
getWildcardCustomMessages(array $messages, string $search, string $default)
Check the given messages for a wildcard key.
in
FormatsMessages at line 201
protected string
getWildcardMessagePattern(string $key, bool $multipleSegments = false)
Build a wildcard message pattern that preserves literal path segments.
in
FormatsMessages at line 222
protected string
getSizeMessage(string $attribute, string $rule)
Get the proper error message for an attribute and size rule.
in
FormatsMessages at line 239
protected string
getAttributeType(string $attribute)
Get the data type of the given attribute.
in
FormatsMessages at line 256
string
makeReplacements(string $message, string $attribute, string $rule, array $parameters)
Replace all error message place-holders with actual values.
Attribute paths and dependent field parameters retain their encoded literal dots and asterisks until display or delivery to a registered custom replacer.
in
FormatsMessages at line 287
string
getDisplayableAttribute(string $attribute)
Get the displayable name of the attribute.
in
FormatsMessages at line 329
protected string|null
getAttributeFromTranslations(string $name)
Get the given attribute from the attribute translations.
in
FormatsMessages at line 341
protected string|null
getAttributeFromLocalArray(string $attribute, array|null $source = null)
Get the custom name for an attribute if it exists in the given array.
in
FormatsMessages at line 367
protected string
replaceAttributePlaceholder(string $message, string $value)
Replace the :attribute placeholder in the given message.
in
FormatsMessages at line 379
protected string
replaceIndexPlaceholder(string $message, string $attribute)
Replace the :index placeholder in the given message.
in
FormatsMessages at line 391
protected string
replacePositionPlaceholder(string $message, string $attribute)
Replace the :position placeholder in the given message.
in
FormatsMessages at line 404
protected string
replaceOrdinalPositionPlaceholder(string $message, string $attribute)
Replace the :ordinal-position placeholder in the given message.
in
FormatsMessages at line 421
protected string
replaceIndexOrPositionPlaceholder(string $message, string $attribute, string $placeholder, Closure|null $modifier = null)
Replace the :index or :position placeholder in the given message.
in
FormatsMessages at line 457
protected string
numberToIndexOrPositionWord(int $value)
Get the word for a index or position segment.
in
FormatsMessages at line 476
protected string
replaceInputPlaceholder(string $message, string $attribute)
Replace the :input placeholder in the given message.
in
FormatsMessages at line 494
string
getDisplayableValue(string $attribute, mixed $value)
Get the displayable name of the value.
in
FormatsMessages at line 526
protected array
getAttributeList(array $values)
Transform an array of attributes to their displayable form.
in
FormatsMessages at line 543
protected string|null
callReplacer(string $message, string $attribute, string $rule, array $parameters, Validator $validator)
Call a custom validator message replacer.
in
FormatsMessages at line 560
protected string
callClassBasedReplacer(string $callback, string $message, string $attribute, string $rule, array $parameters, Validator $validator)
Call a class based validator message replacer.
in
ValidatesAttributes at line 48
bool
validateAccepted(string $attribute, mixed $value)
Validate that an attribute was "accepted".
This validation rule implies the attribute is "required".
in
ValidatesAttributes at line 58
bool
validateAcceptedIf(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute was "accepted" when another attribute has a given value.
in
ValidatesAttributes at line 78
bool
validateDeclined(string $attribute, mixed $value)
Validate that an attribute was "declined".
This validation rule implies the attribute is "required".
in
ValidatesAttributes at line 88
bool
validateDeclinedIf(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute was "declined" when another attribute has a given value.
in
ValidatesAttributes at line 106
bool
validateActiveUrl(string $attribute, mixed $value)
Validate that an attribute is an active URL.
in
ValidatesAttributes at line 130
protected array|false
getDnsRecords(string $hostname, int $type)
Get the DNS records for the given hostname.
in
ValidatesAttributes at line 149
bool
validateAscii(string $attribute, mixed $value)
Validate that an attribute is 7 bit ASCII.
in
ValidatesAttributes at line 157
bool
validateBase64(string $attribute, mixed $value)
Validate that an attribute is a valid Base64 string.
in
ValidatesAttributes at line 173
bool
validateBail()
"Break" on first validation fail.
Always returns true, just lets us put "bail" in rules.
in
ValidatesAttributes at line 183
bool
validateBefore(string $attribute, mixed $value, mixed $parameters)
Validate the date is before a given date.
in
ValidatesAttributes at line 195
bool
validateBeforeOrEqual(string $attribute, mixed $value, mixed $parameters)
Validate the date is before or equal a given date.
in
ValidatesAttributes at line 207
bool
validateAfter(string $attribute, mixed $value, mixed $parameters)
Validate the date is after a given date.
in
ValidatesAttributes at line 219
bool
validateAfterOrEqual(string $attribute, mixed $value, mixed $parameters)
Validate the date is equal or after a given date.
in
ValidatesAttributes at line 231
protected bool
compareDates(string $attribute, mixed $value, array $parameters, string $operator)
Compare a given date against another using an operator.
in
ValidatesAttributes at line 261
protected string|null
getDateFormat(string $attribute)
Get the date format for an attribute if it has one.
in
ValidatesAttributes at line 277
protected int|null
getDateTimestamp(mixed $value)
Get the date timestamp.
in
ValidatesAttributes at line 292
protected bool
checkDateTimeOrder(string $format, mixed $value, mixed $argument, string $operator)
Compare a date value with a literal or referenced field using the given format.
in
ValidatesAttributes at line 325
protected DateTimeInterface|null
getDateTimeWithOptionalFormat(string $format, mixed $value)
Get a DateTime instance from a supported value using the given format.
in
ValidatesAttributes at line 345
protected DateTimeInterface|null
getDateTime(DateTimeInterface|float|int|string $value)
Get a DateTime instance from a string with no format.
in
ValidatesAttributes at line 361
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.
in
ValidatesAttributes at line 377
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.
in
ValidatesAttributes at line 396
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.
in
ValidatesAttributes at line 414
bool
validateArray(string $attribute, mixed $value, array $parameters = [])
Validate that an attribute is an array.
in
ValidatesAttributes at line 433
protected array
acceptedArrayKeys(array $parameters)
Get the accepted literal and encoded array keys.
in
ValidatesAttributes at line 446
bool
validateArrayKeys(string $attribute, mixed $value, array $parameters)
Validate that an array does not contain any keys other than the given keys.
in
ValidatesAttributes at line 460
bool
validateList(string $attribute, mixed $value)
Validate that an attribute is a list.
in
ValidatesAttributes at line 470
bool
validateRequiredArrayKeys(string $attribute, mixed $value, array $parameters)
Validate that an array has all of the given keys.
in
ValidatesAttributes at line 491
bool
validateBetween(string $attribute, mixed $value, array $parameters)
Validate the size of an attribute is between a set of values.
in
ValidatesAttributes at line 510
bool
validateBoolean(string $attribute, mixed $value, array $parameters)
Validate that an attribute is a boolean.
in
ValidatesAttributes at line 526
bool
validateConfirmed(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute has a matching confirmation.
in
ValidatesAttributes at line 536
bool
validateContains(string $attribute, mixed $value, mixed $parameters)
Validate an attribute contains a list of values.
in
ValidatesAttributes at line 557
bool
validateDoesntContain(string $attribute, mixed $value, mixed $parameters)
Validate an attribute does not contain a list of values.
in
ValidatesAttributes at line 578
protected bool
validateCurrentPassword(string $attribute, mixed $value, mixed $parameters)
Validate that the password of the currently authenticated user matches the given value.
in
ValidatesAttributes at line 595
bool
validateDate(string $attribute, mixed $value)
Validate that an attribute is a valid date.
in
ValidatesAttributes at line 607
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.
in
ValidatesAttributes at line 631
bool
validateDateFormat(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute matches a date format.
in
ValidatesAttributes at line 654
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.
in
ValidatesAttributes at line 675
bool
validateDateEquals(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is equal to another date.
in
ValidatesAttributes at line 687
bool
validateDecimal(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute has a given number of decimal places.
in
ValidatesAttributes at line 716
bool
validateDifferent(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is different from another attribute.
in
ValidatesAttributes at line 738
bool
validateDigits(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute has a given number of digits.
in
ValidatesAttributes at line 752
bool
validateDigitsBetween(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is between a given number of digits.
in
ValidatesAttributes at line 771
bool
validateDimensions(string $attribute, mixed $value, mixed $parameters)
Validate the dimensions of an image matches the given values.
in
ValidatesAttributes at line 808
protected bool
failsBasicDimensionChecks(array $parameters, int $width, int $height)
Test if the given width and height fail any conditions.
in
ValidatesAttributes at line 821
protected bool
failsRatioCheck(array $parameters, int $width, int $height)
Determine if the given parameters fail a dimension ratio check.
in
ValidatesAttributes at line 880
bool
validateDistinct(string $attribute, mixed $value, mixed $parameters)
Validate an attribute is unique among other values.
in
ValidatesAttributes at line 900
protected array
getDistinctValues(string $attribute)
Get the values to distinct between.
in
ValidatesAttributes at line 919
protected array
extractDistinctValues(string $attribute)
Extract the distinct values from the data.
in
ValidatesAttributes at line 938
bool
validateEmail(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is a valid e-mail address.
in
ValidatesAttributes at line 977
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.
in
ValidatesAttributes at line 995
bool
validateEncoding(string $attribute, mixed $value, array $parameters)
Validate the encoding of an attribute.
in
ValidatesAttributes at line 1017
bool
validateExists(string $attribute, mixed $value, mixed $parameters)
Validate the existence of an attribute value in a database table.
in
ValidatesAttributes at line 1048
protected int
getExistCount(mixed $connection, string $table, string $column, mixed $value, array $parameters)
Get the number of records that exist in storage.
in
ValidatesAttributes at line 1072
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.
in
ValidatesAttributes at line 1119
protected array
getUniqueIds(string|null $idColumn, array $parameters)
Get the excluded ID column and value for the unique rule.
in
ValidatesAttributes at line 1129
protected int|string|null
prepareUniqueId(mixed $id)
Prepare the given ID for querying.
in
ValidatesAttributes at line 1151
protected array
getUniqueExtra(array $parameters)
Get the extra conditions for a unique rule.
in
ValidatesAttributes at line 1165
array
parseTable(string $table)
Parse the connection / table for the unique / exists rules.
in
ValidatesAttributes at line 1193
bool|string
getQueryColumn(array $parameters, string $attribute)
Get the column name for an exists / unique query.
in
ValidatesAttributes at line 1203
string
guessColumnForQuery(string $attribute)
Guess the database column from the given attribute name.
in
ValidatesAttributes at line 1217
protected array
getExtraConditions(array $segments)
Get the extra conditions for a unique / exists rule.
in
ValidatesAttributes at line 1235
bool
validateExtensions(string $attribute, mixed $value, array $parameters)
Validate the extension of a file upload attribute is in a set of defined extensions.
in
ValidatesAttributes at line 1251
bool
validateFile(string $attribute, mixed $value)
Validate the given value is a valid file.
in
ValidatesAttributes at line 1259
bool
validateFilled(string $attribute, mixed $value)
Validate the given attribute is filled if it is present.
in
ValidatesAttributes at line 1273
bool
validateGt(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is greater than another attribute.
in
ValidatesAttributes at line 1317
bool
validateLt(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is less than another attribute.
in
ValidatesAttributes at line 1361
bool
validateGte(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is greater than or equal another attribute.
in
ValidatesAttributes at line 1405
bool
validateLte(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is less than or equal another attribute.
in
ValidatesAttributes at line 1447
bool
validateLowercase(string $attribute, mixed $value)
Validate that an attribute is lowercase.
in
ValidatesAttributes at line 1455
bool
validateUppercase(string $attribute, mixed $value)
Validate that an attribute is uppercase.
in
ValidatesAttributes at line 1463
bool
validateHexColor(string $attribute, mixed $value)
Validate that an attribute is a valid HEX color.
in
ValidatesAttributes at line 1474
bool
validateImage(string $attribute, mixed $value, array $parameters = [])
Validate the MIME type of a file is an image MIME type.
in
ValidatesAttributes at line 1490
bool
validateIn(string $attribute, mixed $value, mixed $parameters)
Validate an attribute is contained within a list of values.
in
ValidatesAttributes at line 1518
bool
validateInArray(string $attribute, mixed $value, mixed $parameters)
Validate that the values of an attribute are in another attribute.
in
ValidatesAttributes at line 1538
bool
validateInArrayKeys(string $attribute, mixed $value, array $parameters)
Validate that an array contains at least one of the given keys.
in
ValidatesAttributes at line 1563
bool
validateInteger(string $attribute, mixed $value, array $parameters = [])
Validate that an attribute is an integer.
in
ValidatesAttributes at line 1575
bool
validateIp(string $attribute, mixed $value)
Validate that an attribute is a valid IP.
in
ValidatesAttributes at line 1583
bool
validateIpv4(string $attribute, mixed $value)
Validate that an attribute is a valid IPv4.
in
ValidatesAttributes at line 1591
bool
validateIpv6(string $attribute, mixed $value)
Validate that an attribute is a valid IPv6.
in
ValidatesAttributes at line 1599
protected bool
isValidIp(string $value)
Determine if a value is a valid IP address (any version).
in
ValidatesAttributes at line 1607
protected bool
isValidIpv4(string $value)
Determine if a value is a valid IPv4 address.
in
ValidatesAttributes at line 1615
protected bool
isValidIpv6(string $value)
Determine if a value is a valid IPv6 address.
in
ValidatesAttributes at line 1623
bool
validateMacAddress(string $attribute, mixed $value)
Validate that an attribute is a valid MAC address.
in
ValidatesAttributes at line 1631
bool
validateJson(string $attribute, mixed $value)
Validate the attribute is a valid JSON string.
in
ValidatesAttributes at line 1645
bool
validateMax(string $attribute, mixed $value, mixed $parameters)
Validate the size of an attribute is less than or equal to a maximum value.
in
ValidatesAttributes at line 1665
bool
validateMaxDigits(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute has a maximum number of digits.
in
ValidatesAttributes at line 1683
bool
validateMimes(string $attribute, mixed $value, mixed $parameters)
Validate the guessed extension of a file upload is in a set of file extensions.
in
ValidatesAttributes at line 1705
bool
validateMimetypes(string $attribute, mixed $value, mixed $parameters)
Validate the MIME type of a file upload attribute is in a set of MIME types.
in
ValidatesAttributes at line 1725
protected bool
shouldBlockPhpUpload(mixed $value, array $parameters)
Check if PHP uploads are explicitly allowed.
in
ValidatesAttributes at line 1752
bool
validateMin(string $attribute, mixed $value, mixed $parameters)
Validate the size of an attribute is greater than or equal to a minimum value.
in
ValidatesAttributes at line 1768
bool
validateMinDigits(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute has a minimum number of digits.
in
ValidatesAttributes at line 1788
bool
validateMissing(mixed $attribute, mixed $value, array<int, int|string> $parameters)
Validate that an attribute is missing.
in
ValidatesAttributes at line 1798
bool
validateMissingIf(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is missing when another attribute has a given value.
in
ValidatesAttributes at line 1816
bool
validateMissingUnless(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is missing unless another attribute has a given value.
in
ValidatesAttributes at line 1834
bool
validateMissingWith(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is missing when any given attribute is present.
in
ValidatesAttributes at line 1850
bool
validateMissingWithAll(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is missing when all given attributes are present.
in
ValidatesAttributes at line 1868
bool
validateMultipleOf(string $attribute, mixed $value, mixed $parameters)
Validate the value of an attribute is a multiple of a given value.
in
ValidatesAttributes at line 1880
protected bool
isMultipleOf(mixed $value, mixed $divisor)
Determine if a value is an exact multiple of a divisor.
in
ValidatesAttributes at line 1913
bool
validateNullable()
"Indicate" validation should pass if value is null.
Always returns true, just lets us put "nullable" in rules.
in
ValidatesAttributes at line 1923
bool
validateNotIn(string $attribute, mixed $value, mixed $parameters)
Validate an attribute is not contained within a list of values.
in
ValidatesAttributes at line 1933
bool
validateNumeric(string $attribute, mixed $value, array $parameters = [])
Validate that an attribute is numeric.
in
ValidatesAttributes at line 1945
bool
validatePresent(string $attribute, mixed $value)
Validate that an attribute exists even if not filled.
in
ValidatesAttributes at line 1955
bool
validatePresentIf(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is present when another attribute has a given value.
in
ValidatesAttributes at line 1973
bool
validatePresentUnless(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is present unless another attribute has a given value.
in
ValidatesAttributes at line 1991
bool
validatePresentWith(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is present when any given attribute is present.
in
ValidatesAttributes at line 2007
bool
validatePresentWithAll(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is present when all given attributes are present.
in
ValidatesAttributes at line 2023
bool
validateRegex(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute passes a regular expression check.
in
ValidatesAttributes at line 2039
bool
validateNotRegex(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute does not pass a regular expression check.
in
ValidatesAttributes at line 2053
bool
validateRequired(string $attribute, mixed $value)
Validate that a required attribute exists.
in
ValidatesAttributes at line 2074
bool
validateRequiredIf(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute exists when another attribute has a given value.
in
ValidatesAttributes at line 2094
bool
validateRequiredIfAccepted(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute exists when another attribute was "accepted".
in
ValidatesAttributes at line 2108
bool
validateRequiredIfDeclined(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute exists when another attribute was "declined".
in
ValidatesAttributes at line 2122
bool
validateProhibited(string $attribute, mixed $value)
Validate that an attribute does not exist or is an empty string.
in
ValidatesAttributes at line 2130
bool
validateProhibitedIf(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute does not exist when another attribute has a given value.
in
ValidatesAttributes at line 2146
bool
validateProhibitedIfAccepted(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute does not exist when another attribute was "accepted".
in
ValidatesAttributes at line 2160
bool
validateProhibitedIfDeclined(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute does not exist when another attribute was "declined".
in
ValidatesAttributes at line 2174
bool
validateProhibitedUnless(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute does not exist unless another attribute has a given value.
in
ValidatesAttributes at line 2190
bool
validateProhibits(string $attribute, mixed $value, mixed $parameters)
Validate that other attributes do not exist when this attribute exists.
in
ValidatesAttributes at line 2206
bool
validateExclude()
Indicate that an attribute is excluded.
in
ValidatesAttributes at line 2214
bool
validateExcludeIf(string $attribute, mixed $value, mixed $parameters)
Indicate that an attribute should be excluded when another attribute has a given value.
in
ValidatesAttributes at line 2230
bool
validateExcludeUnless(string $attribute, mixed $value, mixed $parameters)
Indicate that an attribute should be excluded when another attribute does not have a given value.
in
ValidatesAttributes at line 2242
bool
validateRequiredUnless(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute exists when another attribute does not have a given value.
in
ValidatesAttributes at line 2258
bool
validateExcludeWith(string $attribute, mixed $value, mixed $parameters)
Indicate that an attribute should be excluded when another attribute presents.
in
ValidatesAttributes at line 2272
bool
validateExcludeWithout(string $attribute, mixed $value, mixed $parameters)
Indicate that an attribute should be excluded when another attribute is missing.
in
ValidatesAttributes at line 2288
array
parseDependentRuleParameters(array $parameters)
Prepare the values and the other value for validation.
in
ValidatesAttributes at line 2308
protected bool
shouldConvertToBoolean(string $parameter)
Check if parameter should be converted to boolean.
in
ValidatesAttributes at line 2316
protected array
convertValuesToBoolean(array $values)
Convert the given values to boolean if they are string "true" / "false".
in
ValidatesAttributes at line 2328
protected array
convertValuesToNull(array $values)
Convert the given values to null if they are string "null".
in
ValidatesAttributes at line 2338
bool
validateRequiredWith(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute exists when any other attribute exists.
in
ValidatesAttributes at line 2350
bool
validateRequiredWithAll(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute exists when all other attributes exist.
in
ValidatesAttributes at line 2362
bool
validateRequiredWithout(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute exists when another attribute does not.
in
ValidatesAttributes at line 2374
bool
validateRequiredWithoutAll(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute exists when all other attributes do not.
in
ValidatesAttributes at line 2386
protected bool
anyFailingRequired(array $attributes)
Determine if any of the given attributes fail the required test.
in
ValidatesAttributes at line 2401
protected bool
allFailingRequired(array $attributes)
Determine if all of the given attributes fail the required test.
in
ValidatesAttributes at line 2418
bool
validateSame(string $attribute, mixed $value, mixed $parameters)
Validate that two attributes match.
in
ValidatesAttributes at line 2432
bool
validateSize(string $attribute, mixed $value, mixed $parameters)
Validate the size of an attribute.
in
ValidatesAttributes at line 2448
bool
validateSometimes()
"Validate" optional attributes.
Always returns true, just lets us put sometimes in rules.
in
ValidatesAttributes at line 2458
bool
validateStartsWith(string $attribute, mixed $value, mixed $parameters)
Validate the attribute starts with a given substring.
in
ValidatesAttributes at line 2472
bool
validateDoesntStartWith(string $attribute, mixed $value, mixed $parameters)
Validate the attribute does not start with a given substring.
in
ValidatesAttributes at line 2486
bool
validateEndsWith(string $attribute, mixed $value, mixed $parameters)
Validate the attribute ends with a given substring.
in
ValidatesAttributes at line 2500
bool
validateDoesntEndWith(string $attribute, mixed $value, mixed $parameters)
Validate the attribute does not end with a given substring.
in
ValidatesAttributes at line 2512
bool
validateString(string $attribute, mixed $value)
Validate that an attribute is a string.
in
ValidatesAttributes at line 2522
bool
validateTimezone(string $attribute, mixed $value, array $parameters = [])
Validate that an attribute is a valid timezone.
in
ValidatesAttributes at line 2542
bool
validateUrl(string $attribute, mixed $value, array $parameters = [])
Validate that an attribute is a valid URL.
in
ValidatesAttributes at line 2550
bool
validateUlid(string $attribute, mixed $value)
Validate that an attribute is a valid ULID.
in
ValidatesAttributes at line 2558
protected bool
isValidUlid(string $value)
Determine if a value is a valid ULID.
in
ValidatesAttributes at line 2568
bool
validateUuid(string $attribute, mixed $value, mixed $parameters)
Validate that an attribute is a valid UUID.
in
ValidatesAttributes at line 2590
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.
in
ValidatesAttributes at line 2598
protected float|int|string
getSize(string $attribute, mixed $value)
Get the size of an attribute.
in
ValidatesAttributes at line 2610
protected float|int|string
sizeOf(string $attribute, mixed $value, bool $numeric)
Compute the validation size from numeric semantics and runtime value shape.
in
ValidatesAttributes at line 2630
bool
isValidFileInstance(mixed $value)
Check that the given value is a valid file instance.
in
ValidatesAttributes at line 2644
protected bool
compare(mixed $first, mixed $second, string $operator)
Determine if a comparison passes between the given values.
in
ValidatesAttributes at line 2663
array|null
parseNamedParameters(array $parameters)
Parse named parameters to $key => $value items.
in
ValidatesAttributes at line 2679
void
requireParameterCount(int $count, array $parameters, string $rule)
Require a certain number of parameters to be present.
in
ValidatesAttributes at line 2689
protected bool
isSameType(mixed $first, mixed $second)
Check if the parameters are of the same type.
in
ValidatesAttributes at line 2697
protected void
shouldBeNumeric(string $attribute, string $rule)
Adds the existing rule to the numericRules array if the attribute's value is numeric.
in
ValidatesAttributes at line 2707
protected mixed
trim(mixed $value)
Trim the value if it is a string.
in
ValidatesAttributes at line 2715
protected mixed
ensureExponentWithinAllowedRange(string $attribute, mixed $value)
Ensure the exponent is within the allowed range.
in
PlanExecutor at line 64
protected void
executeCompiledPlans(array $compiledPlans, array $preExcludedAttributes)
Execute all compiled plans against the validation data.
Per-check fresh reads of $value and $exists match validateAttribute()'s per-rule getValue() call.
in
PlanExecutor at line 141
protected void
executeDelegatedPlans(array $compiledPlans)
Execute all-delegated plans for a Validator subclass.
in
PlanExecutor at line 171
protected bool
shouldSkipNonImplicitCheck(AttributePlan $plan, mixed $value, bool $exists)
Determine if a non-implicit check should be skipped.
in
PlanExecutor at line 181
protected bool
shouldFailInvalidUpload(string $attribute, mixed $value)
Determine if an invalid upload should fail before rule execution.
in
PlanExecutor at line 191
protected bool
canPreflightInline(InlineCheck $check, mixed $value)
Determine if an inline check is safe to repeat during presence preflight.
in
PlanExecutor at line 256
protected bool
executeInline(InlineCheck $check, mixed $value, string $attribute)
Execute an inline check against a value.
Dispatches via exhaustive match over CheckType — no default arm. Adding a CheckType case without a handler here fails PHPStan and throws UnhandledMatchError at runtime. Silent passes are impossible.
Each arm replicates the exact logic of the corresponding validate*() method in ValidatesAttributes, but without parameter parsing, attribute context lookups, or dynamic method dispatch.
in
Validator at line 354
__construct(Translator $translator, array $data, array $rules, array $messages = [], array $attributes = [])
Create a new Validator instance.
in
Validator at line 372
array
parseData(array $data)
Parse the data array, converting dots and asterisks.
in
Validator at line 380
protected array
replacePlaceholders(array $data)
Replace the placeholders used in data keys.
in
Validator at line 388
protected string
replacePlaceholderInString(string $value)
Replace the placeholders in the given string.
in
Validator at line 396
protected array
replaceDotPlaceholderInParameters(array $parameters)
Replace each field parameter key placeholder.
in
Validator at line 407
Validator
after(callable|string $callback)
Add an after validation callback.
at line 413
bool
passes()
Determine if the data passes the validation rules using the legacy path.
in
Validator at line 491
protected array
compileRules()
Compile all attribute rules into AttributePlans.
For the base Validator class, rules are compiled with inlining and cached worker-lifetime. Subclasses compile everything as DelegatedCheck to preserve validate*() overrides.
in
Validator at line 526
protected bool
compiledPlansUseDataMutatingRules()
Determine if any compiled check can mutate this validator's data.
in
Validator at line 574
protected array
preEvaluateExclusions()
Pre-evaluate safe first-position exclusion checks.
in
Validator at line 698
protected void
maybeBatchDatabaseChecks(DatabasePresenceVerifier $presenceVerifier, array $preExcludedAttributes, array $unresolvedExclusionAttributes)
Batch safe database-presence candidates by query shape.
in
Validator at line 925
bool
fails()
Determine if the data fails the validation rules.
in
Validator at line 939
mixed
whenPasses(callable $callback, callable|null $default = null)
Execute the callback if the data passes the validation rules.
in
Validator at line 960
mixed
whenFails(callable $callback, callable|null $default = null)
Execute the callback if the data fails the validation rules.
in
Validator at line 975
protected bool
shouldBeExcluded(string $attribute)
Determine if the attribute should be excluded.
in
Validator at line 1017
protected void
removeAttribute(string $attribute)
Remove the given attribute.
in
Validator at line 1028
array
validate()
Run the validator's rules against its data.
in
Validator at line 1042
array
validateWithBag(string $errorBag)
Run the validator's rules against its data.
in
Validator at line 1061
array|ValidatedInput
safe(array|null $keys = null)
Get a validated input container for the validated input.
in
Validator at line 1073
array
validated()
Get the attributes and values that were validated.
in
Validator at line 1112
protected void
validateAttribute(string $attribute, array|object|string $rule)
Validate a given attribute against a rule.
in
Validator at line 1169
protected bool
dependsOnOtherFields(object|string $rule)
Determine if the given rule depends on other fields.
in
Validator at line 1179
protected array
getExplicitKeys(string $attribute)
Get the explicit keys from an attribute flattened with dot notation.
E.g. 'foo.1.bar.spark.baz' -> [1, 'spark'] for 'foo..bar..baz'
in
Validator at line 1197
protected string
getPrimaryAttribute(string $attribute)
Get the primary attribute name.
For example, if "name.0" is given, "name.*" will be returned.
in
Validator at line 1225
protected array
replaceDotInParameters(array $parameters)
Replace each escaped field parameter separator with its placeholder.
in
Validator at line 1235
protected array
replaceAsterisksInParameters(array $parameters, array $keys)
Replace each field parameter which has asterisks with the given keys.
in
Validator at line 1245
protected bool
isValidatable(object|string $rule, string $attribute, mixed $value)
Determine if the attribute is validatable.
in
Validator at line 1260
protected bool
presentOrRuleIsImplicit(object|string $rule, string $attribute, mixed $value)
Determine if the field is present, or the rule implies required.
in
Validator at line 1277
protected bool
isImplicit(object|string $rule)
Determine if a given rule implies the attribute is required.
in
Validator at line 1286
protected bool
passesOptionalCheck(string $attribute)
Determine if the attribute passes any optional check.
in
Validator at line 1306
protected bool
isNotNullIfMarkedAsNullable(object|string $rule, string $attribute)
Determine if the attribute fails the nullable check.
in
Validator at line 1329
protected bool
hasNotFailedPreviousRuleIfPresenceRule(object|string $rule, string $attribute)
Determine if it's a necessary presence validation.
This is to avoid possible database type comparison errors.
in
Validator at line 1339
protected void
validateUsingCustomRule(string $attribute, mixed $value, Rule $rule)
Validate an attribute using a custom rule object.
in
Validator at line 1395
protected bool
shouldStopValidating(string $attribute)
Check if we should stop further validations on a given attribute.
in
Validator at line 1421
void
addFailure(string $attribute, string $rule, array $parameters = [])
Add a failed rule and error message to the collection.
in
Validator at line 1457
protected void
excludeAttribute(string $attribute)
Add the given attribute to the list of excluded attributes.
in
Validator at line 1473
array
valid()
Return the data which was valid.
in
Validator at line 1488
array
invalid()
Return the data which was invalid.
in
Validator at line 1513
protected array
attributesThatHaveMessages()
Generate an array of all attributes that have messages.
in
Validator at line 1525
array
failed()
Get the failed validation rules.
in
Validator at line 1533
MessageBag
messages()
Get the message container for the validator.
in
Validator at line 1545
MessageBag
errors()
An alternative more semantic shortcut to the message container.
in
Validator at line 1553
MessageBag
getMessageBag()
Get the messages for the instance.
in
Validator at line 1561
bool
hasRule(string $attribute, array|string $rules)
Determine if the given attribute has a rule in the given set.
in
Validator at line 1569
protected array|null
getRule(string $attribute, array|string $rules)
Get a rule and its parameters for a given attribute.
in
Validator at line 1591
array
attributes()
Get the data under validation.
in
Validator at line 1599
array
getData()
Get the data under validation.
in
Validator at line 1619
mixed
getValue(string $attribute)
Get the value of a given attribute.
in
Validator at line 1627
void
setValue(string $attribute, mixed $value)
Set the value of a given attribute.
in
Validator at line 1635
array
getRules()
Get the validation rules.
in
Validator at line 1643
array
getRulesWithoutPlaceholders()
Get the validation rules with key placeholders removed.
in
Validator at line 1682
Validator
retainRules(array $attributes)
Retain the selected rules from the graph prepared for the current data.
Retention applies only to the current prepared graph. Calling setData() rebuilds the complete original rule graph.
in
Validator at line 1698
Validator
appendRules(array $rules)
Append new validation rules to the validator.
at line 395
void
addRules(array $rules)
Override addRules to use the legacy O(n²) wildcard expansion parser.
in
Validator at line 1735
Validator
sometimes(array|string $attribute, array|string $rules, callable $callback)
Add conditions to a given field based on a Closure.
in
Validator at line 1779
Validator
stopOnFirstFailure(bool $stopOnFirstFailure = true)
Instruct the validator to stop validating after the first rule failure.
in
Validator at line 1789
void
addExtensions(array $extensions)
Register an array of custom validator extensions.
in
Validator at line 1803
void
addImplicitExtensions(array $extensions)
Register an array of custom implicit validator extensions.
in
Validator at line 1815
void
addDependentExtensions(array $extensions)
Register an array of custom dependent validator extensions.
in
Validator at line 1827
void
addExtension(string $rule, Closure|string $extension)
Register a custom validator extension.
in
Validator at line 1835
void
addImplicitExtension(string $rule, Closure|string $extension)
Register a custom implicit validator extension.
in
Validator at line 1845
void
addDependentExtension(string $rule, Closure|string $extension)
Register a custom dependent validator extension.
in
Validator at line 1855
void
addReplacers(array $replacers)
Register an array of custom validator message replacers.
in
Validator at line 1869
void
addReplacer(string $rule, Closure|string $replacer)
Register a custom validator message replacer.
in
Validator at line 1877
Validator
setCustomMessages(array $messages)
Set the custom messages for the validator.
in
Validator at line 1887
Validator
setAttributeNames(array $attributes)
Set the custom attributes on the validator.
in
Validator at line 1897
Validator
addCustomAttributes(array $attributes)
Add custom attributes to the validator.
in
Validator at line 1907
Validator
setImplicitAttributesFormatter(callable|null $formatter = null)
Set the callback that used to format an implicit attribute.
in
Validator at line 1917
Validator
setValueNames(array $values)
Set the custom values on the validator.
in
Validator at line 1927
Validator
addCustomValues(array $customValues)
Add the custom values for the validator.
in
Validator at line 1937
void
setFallbackMessages(array $messages)
Set the fallback messages for the validator.
in
Validator at line 1947
PresenceVerifierInterface
getPresenceVerifier(string|null $connection = null)
Get the Presence Verifier implementation.
in
Validator at line 1966
void
setPresenceVerifier(PresenceVerifierInterface $presenceVerifier)
Set the Presence Verifier implementation.
in
Validator at line 1976
string|ValidationException
getException()
Get the exception to throw upon failed validation.
in
Validator at line 1988
Validator
setException(string|Throwable $exception)
Set the exception to throw upon failed validation.
in
Validator at line 2006
Validator
ensureExponentWithinAllowedRangeUsing(callable $callback)
Ensure exponents are within range using the given callback.
in
Validator at line 2016
Translator
getTranslator()
Get the Translator implementation.
in
Validator at line 2024
void
setTranslator(Translator $translator)
Set the Translator implementation.
in
Validator at line 2040
protected bool|null
callExtension(string $rule, array $parameters)
Call a custom validator extension.
in
Validator at line 2057
protected bool
callClassBasedExtension(string $callback, array $parameters)
Call a class based validator extension.
in
Validator at line 2068
static protected string
encodeAttributeWithPlaceholder(string $attribute)
Encode the attribute with the placeholder hash.
in
Validator at line 2076
static protected string
decodeAttributeWithPlaceholder(string $attribute)
Decode an attribute with a placeholder hash.
in
Validator at line 2087
static void
fakeDnsLookups(bool $value = true)
Fake the DNS lookups performed by validation rules so they always succeed.
Tests only. The setting persists for the worker lifetime; failing to reset it through Validator::flushState() can make later tests bypass real DNS validation.
in
Validator at line 2095
static void
flushState()
Flush all static state.
in
Validator at line 2107
mixed
__call(string $method, array $parameters)
Handle dynamic calls to class methods.