Yii Validator

1.3.0 2024-04-04 11:44 UTC

This package is auto-updated.

Last update: 2024-04-15 09:50:09 UTC



Yii Validator

Latest Stable Version Total Downloads Build status Code Coverage Mutation testing badge type-coverage static analysis psalm-level

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 attribute.
    • 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.0 or higher.
  • mbstring PHP extension.


The package could be installed with composer:

composer require yiisoft/validator

General usage

Validator allows to check data in any format. For example, when data is an object:

use Yiisoft\Validator\Rule\AtLeast;
use Yiisoft\Validator\Rule\Email;
use Yiisoft\Validator\Rule\Length;
use Yiisoft\Validator\Rule\Number;
use Yiisoft\Validator\Rule\Required;
use Yiisoft\Validator\Validator;

#[AtLeast(['email', 'phone'])]
final class Person
    public function __construct(
        #[Length(min: 2)]
        public ?string $name = null,

        #[Number(min: 21)]
        public ?int $age = null,

        public ?string $email = null,

        public ?string $phone = null,
    ) {

$person = new Person(
    name: 'John', 
    age: 17, 
    email: 'john@example.com',
    phone: null

$result = (new Validator())->validate($person);

The validation result is an object that allows to check whether validation was successful:


It also contains errors occurred during validation:




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.

Support the project

Open Collective

Follow updates

Official website Twitter Telegram Facebook Slack