 |
VOOZH | about |
|
VOOZH | about |
This document provides a deep dive into the Validator class, the central orchestrator of the validation system. The Validator coordinates validation execution, manages validation state, collects errors, and integrates with external dependencies to provide a complete validation solution.
The Validator uses three primary traits to organize its responsibilities:
For detailed information on built-in validation rules, see Built-in Validation Rules. For the complete validation lifecycle, see Validation Lifecycle. For custom rule creation, see Custom Validation Rules.
The Validator class serves as the central orchestrator for all validation operations. It coordinates the execution of validation rules, manages state, collects errors, and provides the public API for validation operations.
Sources: src/Validator.php30-306
The Validator delegates specialized functionality to three core traits:
| Trait | Responsibility | Key Methods | Line Reference |
|---|---|---|---|
ValidatesAttributes | Implements 50+ validation rules | validateEmail(), validateRequired(), validateUnique(), etc. | src/Concerns/ValidatesAttributes.php37-4200 |
FormatsMessages | Error message generation and formatting | getMessage(), makeReplacements(), getDisplayableAttribute() | src/Concerns/FormatsMessages.php1-500 |
ReplacesAttributes | Attribute name transformations | replaceAttributePlaceholder(), getAttributeFromTranslations() | src/Concerns/ReplacesAttributes.php1-200 |
Sources: src/Validator.php32-33 src/Concerns/ValidatesAttributes.php37
The Validator orchestrates the complete validation process through a series of coordinated steps, from rule parsing through error collection to final result reporting.
Sources: src/Validator.php391-441 src/Validator.php554-606 src/Validator.php747-796
Sources: src/Validator.php554-606 src/Validator.php747-796 src/Validator.php827-854
The Validator maintains several categories of state throughout the validation process to track data, rules, errors, and configuration.
| Property | Type | Purpose | Initialization |
|---|---|---|---|
$data | array | Data under validation, with placeholders for dots/asterisks | Constructor via parseData() |
$rules | array | Expanded validation rules (wildcards resolved) | setRules() via ValidationRuleParser |
$initialRules | array | Original rules before wildcard expansion | Constructor |
$messages | MessageBag | Collection of validation error messages | passes() method |
$failedRules | array | Map of attribute => rule => parameters for failures | passes() method |
$excludeAttributes | array | Attributes marked for exclusion from validated data | During validation |
Sources: src/Validator.php58-84
The Validator uses a placeholder system to handle dots and asterisks in attribute names, preventing conflicts with array notation:
Sources: src/Validator.php310-368
The Validator expands wildcard rules to explicit rules for each matching attribute:
Sources: src/Validator.php1069-1085 src/Validator.php640-648
Sources: src/Validator.php827-854 src/Validator.php801-822
The Validator integrates with several external dependencies to provide comprehensive validation capabilities.
The Translator is a required dependency for retrieving localized error messages:
Sources: src/Validator.php288-305 src/Concerns/FormatsMessages.php1-500
The PresenceVerifier enables database validation rules (unique, exists):
Sources: src/Validator.php1297-1316 src/Concerns/ValidatesAttributes.php788-883
The PSR-11 Container enables dependency injection for custom extensions:
Sources: src/Validator.php1377-1409
The Validator provides a flexible extension system for registering custom validation rules, implicit rules, dependent rules, and message replacers.
| Method | Purpose | Behavior | Line Reference |
|---|---|---|---|
addExtension() | Register custom rule | Adds to $extensions array | src/Validator.php1177-1180 |
addImplicitExtension() | Register implicit custom rule | Adds to $extensions and $implicitRules | src/Validator.php1185-1190 |
addDependentExtension() | Register dependent custom rule | Adds to $extensions and $dependentRules | src/Validator.php1195-1200 |
addReplacer() | Register message replacer | Adds to $replacers array | src/Validator.php1219-1222 |
Sources: src/Validator.php1139-1222 src/Validator.php1385-1429
The Validator maintains lists of special rule types that affect validation behavior:
Implicit Rules (e.g., Required, Present): Execute even when attribute is missing from data.
Dependent Rules (e.g., Same, RequiredIf): Reference other attributes; parameters are expanded with wildcard keys.
Sources: src/Validator.php163-236 src/Validator.php688-705 src/Validator.php611-614
The trait includes several categories of helper methods that support the core validation logic.
| Helper Method | Purpose | Usage Context |
|---|---|---|
getSize() | Calculate size of values | Min/max validation |
getDateTimestamp() | Convert to timestamp | Date comparisons |
compare() | Generic comparison | Numeric/date validation |
isSameType() | Type compatibility check | Comparison validation |
| Helper Method | Purpose | Line Reference |
|---|---|---|
requireParameterCount() | Validate parameter count | 4098-4104 |
parseNamedParameters() | Parse key=value parameters | 4116-4124 |
parseDependentRuleParameters() | Parse conditional parameters | 1921-1927 |
getExtraConditions() | Extract query conditions | 981-992 |
| Helper Method | Purpose | Line Reference |
|---|---|---|
isValidFileInstance() | Check file validity | 4050-4053 |
shouldBlockPhpUpload() | PHP file security check | 1386-1404 |
failsBasicDimensionChecks() | Image dimension validation | 639-647 |
Sources: src/Concerns/ValidatesAttributes.php4098-4104 src/Concerns/ValidatesAttributes.php4116-4124 src/Concerns/ValidatesAttributes.php1921-1927
Refresh this wiki