This package provides data validation capabilities.
- Validates any data: arrays, objects, scalar values, etc.
- Supports custom data sets.
- Handles nested data structures (one-to-one and one-to-many).
- Can read validation rules from PHP 8 attributes.
- Error message formatting and translation.
- Attribute names translation.
- Conditional validation:
- Skip validation of "empty" value with possibility to configure "empty" condition.
- Skip further validation if an error occurred for the same property.
- Skip validation depending on a condition.
- Possibility to use context in rule handler.
- Common rules bundled.
- Supports DI container for creating custom rule handlers with extra dependencies.
- Exporting rules options for using in the frontend.
- PHP 8.1 - 8.5.
mbstringPHP extension.
The package could be installed with Composer:
composer require yiisoft/validatorValidator allows to check data in any format. For example, when data is an object:
useYiisoft\Validator\Rule\FilledAtLeast;
useYiisoft\Validator\Rule\Email;
useYiisoft\Validator\Rule\Length;
useYiisoft\Validator\Rule\Number;
useYiisoft\Validator\Rule\Required;
useYiisoft\Validator\Validator;
#[FilledAtLeast(['email', 'phone'])]
finalclass Person
{
publicfunction__construct(
#[Required]
#[Length(min: 2)]
public ?string$name = null,
#[Number(min: 21)]
public ?int$age = null,
#[Email]
public ?string$email = null,
public ?string$phone = null,
) {
}
}
$person = newPerson(
name: 'John', age: 17, email: 'john@example.com',
phone: null
);
$result = (newValidator())->validate($person);The validation result is an object that allows to check whether validation was successful:
$result->isValid();It also contains errors occurred during validation:
$result->getErrorMessages();- Guide: English, Português - Brasil
- Internals
If you need help or have a question, the Yii Forum is a good place for that. You may also check out other Yii Community Resources.
The Yii Validator is free software. It is released under the terms of the BSD License.
Please see LICENSE for more information.
Maintained by Yii Software.
