PHPackages                             fi1a/validation - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Validation & Sanitization](/categories/validation)
4. /
5. fi1a/validation

ActiveLibrary[Validation & Sanitization](/categories/validation)

fi1a/validation
===============

PHP валидация (проверка) значений формы и данных

3.2.1(3y ago)06.2k↓28.6%2MITPHPPHP ^7.3 || ^8

Since Oct 12Pushed 3y ago1 watchersCompare

[ Source](https://github.com/fi1a/validation)[ Packagist](https://packagist.org/packages/fi1a/validation)[ Docs](https://github.com/fi1a/validation)[ RSS](/packages/fi1a-validation/feed)WikiDiscussions main Synced yesterday

READMEChangelog (10)Dependencies (9)Versions (18)Used By (2)

PHP валидация (проверка) значений формы и данных
================================================

[](#php-валидация-проверка-значений-формы-и-данных)

[![Latest Version](https://camo.githubusercontent.com/e0ecd9808cd87cf123b2d199b273758930283af9b42b6543ee8996970c2dce63/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666931612f76616c69646174696f6e3f6c6162656c3d72656c65617365)](https://packagist.org/packages/fi1a/validation)[![Software License](https://camo.githubusercontent.com/1581f5c39faff638290992a198b27575f0b2e6a6c68c1d1632ec217c6367df01/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f666931612f76616c69646174696f6e3f7374796c653d666c61742d737175617265)](https://github.com/fi1a/validation/blob/master/LICENSE)[![PHP Version](https://camo.githubusercontent.com/85f934f7b200b9e2c085bc03bd000a086ed01f2fe7700e46a7ca24e2aada8dd3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f666931612f76616c69646174696f6e3f7374796c653d666c61742d737175617265)](https://php.net)[![Coverage Status](https://camo.githubusercontent.com/0c967d746eb7f4fe28065a3b94d23faa207cd6f4a968535b20fce0310a87cf89/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f7665726167652d3130302532352d677265656e)](https://camo.githubusercontent.com/0c967d746eb7f4fe28065a3b94d23faa207cd6f4a968535b20fce0310a87cf89/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f7665726167652d3130302532352d677265656e)[![Total Downloads](https://camo.githubusercontent.com/49e25522f9128df962f57e2101744166b63bb1643520e25dfadce2fb88849309/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f666931612f76616c69646174696f6e2e7376673f7374796c653d666c61742d73717561726526636f6c6f72423d6d656469756d76696f6c6574726564)](https://packagist.org/packages/fi1a/validation)[![Support mail](https://camo.githubusercontent.com/116fa0d447870a3a6c6c1f4b296c889707a6e30a69c2b28cbe8d0f6f5c3d4920/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d61696c2d737570706f7274253430666931612e72752d627269676874677265656e)](mailto:support@fi1a.ru)

Валидация означает проверку данных, заполняемых пользователем. Пакет предоставляет возможность организовать проверку на стороне сервера после отправки данных формы.

Возможности
-----------

[](#возможности)

- Проверка (валидация) данных массива и отдельного значения;
- Проверка (валидация) значений формы и загружаемых файлов;
- Поддержка набора правил со сценариями;
- Возможность изменить названия полей;
- Возможность изменить текст ошибки;
- Возможность расширить пользовательскими правилами проверки;
- Сценарии и наборы правил;
- Проверка публичных полей объекта.

Установка
---------

[](#установка)

Установить этот пакет можно как зависимость, используя Composer.

```
composer require fi1a/validation
```

Проверка данных полей формы
---------------------------

[](#проверка-данных-полей-формы)

Для проверки данных полей формы нужно использовать метод `make` класса валидатора `\Fi1a\Validation\Validator`. После создания объекта валидации необходимо вызвать метод `validate` для проверки переданных значений. При вызове `validate` возвращается объект результата проверки `\Fi1a\Validation\Result`.

Пример:

```
use Fi1a\Validation\Validator;

$validator = new Validator();

$validation = $validator->make($_POST + $_FILES, [
    'id' => 'required|integer',
    'email' => 'required|email',
    'password' => 'required|minLength(8)',
    'confirm_password' => 'required|same("password")',
    'tags' => 'array|required',
    'tags:*:id' => 'required|numeric',
]);

$result = $validation->validate();

if (!$result->isSuccess()) {
    echo $result->getErrors()->join("\n");
}
```

Проверка одного поля
--------------------

[](#проверка-одного-поля)

Для проверки одного поля нужно использовать один из классов цепочки правил. Цепочки правил реализует "Fluent interface" для объявления используемых правил.

Цепочка "значение должно удовлетворять всем правилам" (`Fi1a\Validation\AllOf`):

```
use Fi1a\Validation\AllOf;

$result = AllOf::create()->required()->integer()->validate('abc');

if (!$result->isSuccess()) {
    echo $result->getErrors()->join("; "); // "Значение не является целым числом"
}
```

Цепочка "значение должно удовлетворять одному из правил" (`Fi1a\Validation\OneOf`):

```
use Fi1a\Validation\OneOf;

$chain = OneOf::create()->integer()->boolean();

$result = $chain->validate(true);
echo $result->isSuccess(); // true

$result = $chain->validate(10);
echo $result->isSuccess(); // true

$result = $chain->validate(null);
echo $result->isSuccess(); // false
echo $result->getErrors()->join("; "); // Значение не является целым числом; Значение должно быть логическим
```

Пример совместного использования цепочек правил. Значение может быть числом большим 10 или строкой с минимальной длиной 2:

```
use Fi1a\Validation\AllOf;
use Fi1a\Validation\OneOf;

$chain = OneOf::create(
    AllOf::create()->numeric()->min(10),
    AllOf::create()->alpha()->minLength(2)
);

$result = $chain->validate(20);
echo $result->isSuccess(); // true

$result = $chain->validate('abc');
echo $result->isSuccess(); // true

$result = $chain->validate('a');
echo $result->isSuccess(); // false
echo $result->getErrors()->join("; "); // Значение не является числом; Значение должно быть минимум 10; Длина значения должна быть больше 2
```

Проверка объекта
----------------

[](#проверка-объекта)

Вместо массива значений можно передать объект для проверки значений свойств объекта (осуществляется проверка только публичных свойств объекта):

```
class DTO
{
    public $propertyA = 100;

    public $propertyB = 'string';

    public $propertyC;

    public $propertyD = true;

    public function getPropertyD(): bool
    {
        return $this->propertyD;
    }
}

use Fi1a\Validation\Validator;

$validator = new Validator();

$validation = $validator->make(
    new DTO(),
    [
        'propertyA' => 'required|integer',
        'propertyB' => 'required',
        'propertyC' => 'null',
        'propertyD' => 'required|boolean',
    ]
);

$result = $validation->validate();
$result->isSuccess(); // true
```

Сообщения об ошибках
--------------------

[](#сообщения-об-ошибках)

Сообщения об ошибках можно задать при создании объекта валидации с помощью метода `make`, передав в него массив с сообщениями, либо позже методами `setMessage` или `setMessages` объекта валидации. Также сообщения можно определить в наборе правил `Fi1a\Validation\RuleSetInterface` (возвращаемый массив метода `getMessages`).

```
use Fi1a\Validation\Validator;

$validator = new Validator();

$validation = $validator->make($_POST + $_FILES, [
    'firstName' => 'required|betweenLength(2, 40)',
    'lastName' => 'required|betweenLength(2, 40)',
], [
    'required' => 'Очень обязательное поле',
    'lastName|required' => '"Фамилия" обязательное поле',
]);

$result = $validation->validate();

if (!$result->isSuccess()) {
    echo $result->getErrors()->join("; "); // Очень обязательное поле; "Фамилия" обязательное поле
}

$validation->setMessage('firstName|required', 'Очень обязательное поле 2');
$validation->setMessage('required', '"Фамилия" обязательное поле 2');
$validation->setMessage('lastName|required', null);

$result = $validation->validate();

if (!$result->isSuccess()) {
    echo $result->getErrors()->join("; "); // Очень обязательное поле 2; "Фамилия" обязательное поле 2
}
```

Заголовки полей
---------------

[](#заголовки-полей)

Заголовки полей можно задать при создании объекта валидации с помощью метода `make`, передав в него заголовки, либо позже методами `setTitle` или `setTitles` объекта валидации. Также заголовки можно определить в наборе правил `Fi1a\Validation\RuleSetInterface` (возвращаемый массив метода `getTitles`).

```
use Fi1a\Validation\Validator;

$validator = new Validator();

$validation = $validator->make($_POST + $_FILES, [
    'firstName' => 'required|betweenLength(2, 40)',
    'lastName' => 'required|betweenLength(2, 40)',
], [], [
    'firstName' => 'Имя',
    'lastName' => 'Фамилия',
]);

$result = $validation->validate();

if (!$result->isSuccess()) {
    echo $result->getErrors()->join("; "); // Значение "Имя" является обязательным; Значение "Фамилия" является обязательным
}

$validation->setTitle('firstName', null);
$validation->setTitle('lastName', null);

$result = $validation->validate();

if (!$result->isSuccess()) {
    echo $result->getErrors()->join("; "); // Значение является обязательным; Значение является обязательным
}
```

Ошибки
------

[](#ошибки)

Сообщения об ошибках представлены коллекцией `\Fi1a\Validation\Errors`, которую можно получить с помощью метода `getErrors()` класса результата проверки `\Fi1a\Validation\Result`.

```
use Fi1a\Validation\Validator;

$validator = new Validator();

$validation = $validator->make($_POST + $_FILES, [
    'id' => 'required|integer',
    'email' => 'required|email',
]);

$result = $validation->validate();

if (!$result->isSuccess()) {
    $errors = $result->getErrors(); // \Fi1a\Validation\Errors
    echo $errors->firstOfAll()->join('; ');
}
```

Доступные методы в коллекции ошибок `\Fi1a\Validation\Errors`:

- `firstOfAll()` - возвращает первые ошибки для поля;
- `allForField()` - возвращает все ошибки для конкретного поля;
- `firstOfField()` - возвращает первую ошибку для конкретного поля;
- `allForRule()` - возвращает все ошибки для конкретного правила;
- `asArray(bool $flat = true)` - возвращает массив с сообщениями об ошибках (аргумент $flat определяет в каком виде будет сформирован массив с сообщениями об ошибках).

Также доступны все методы коллекции `\Fi1a\Collection\Collection`.

Затронутые значения
-------------------

[](#затронутые-значения)

Затронутые значения представлены коллекцией `\Fi1a\Validation\ResultValues`, которую можно получить с помощью метода `getValues()` класса результата проверки `\Fi1a\Validation\Result`.

```
use Fi1a\Validation\Validator;

$validator = new Validator();

$validation = $validator->make($_POST + $_FILES, [
    'id' => 'required|integer',
    'email' => 'required|email',
]);

$result = $validation->validate();

if (!$result->isSuccess()) {
    $values = $result->getValues(); // \Fi1a\Validation\ResultValues|\Fi1a\Validation\Value[]
    $values->getInvalid(); // \Fi1a\Validation\ResultValues|\Fi1a\Validation\Value[]
    $values->getValid(); // \Fi1a\Validation\ResultValues|\Fi1a\Validation\Value[]
}
```

Доступные методы в коллекции `\Fi1a\Validation\ResultValues`:

- `getInvalid()` - значения не прошедшие проверку;
- `getValid()` - значения успешно прошедшие проверку.

Также доступны все методы коллекции `\Fi1a\Collection\Collection`.

Сценарии
--------

[](#сценарии)

Сценарии предназначены для определения какие правила применять к текущему состоянию. Например: при сценарии создания пароль обязателен для заполнения, а при сценарии обновления нет. Это можно определить используя сценарии.

Класс `Fi1a\Validation\On` задает к какому сценарию относится цепочка правил.

АргументОписаниеstring $fieldNameИмя поля для которого предназначена цепочка правил?ChainInterface $chainЦепочка правилstring ...$scenarioСценарии для которых применяется цепочка правилТекущий используемый сценарий передается пятым аргументом в метод `make` класса `Fi1a\Validation\Validator`.

```
use Fi1a\Validation\AllOf;
use Fi1a\Validation\On;
use Fi1a\Validation\Validator;

$validator = new Validator();
$values = [
    'key1' => [1, 2, 3],
];
$rules = [
    'key1' => 'array',
    new On('key1', AllOf::create()->minCount(1), 'create'),
    new On('key1', AllOf::create()->minCount(4), 'update'),
    'key1:*' => 'required|integer',
];
$validation = $validator->make(
    $values,
    $rules,
    [],
    [],
    'create'
);
$result = $validation->validate();
$result->isSuccess(); // true

$validation = $validator->make(
    $values,
    $rules,
    [],
    [],
    'update'
);
$result = $validation->validate();
$result->isSuccess(); // false
```

Набор правил
------------

[](#набор-правил)

Набор правил представляет собой класс реализующий интерфейс `\Fi1a\Validation\RuleSetInterface`.

Используя класс набора правил можно определить:

- правила для полей;
- сценарий к которому относится правило;
- заголовки полей;
- сообщения об ошибках.

Пример набора правил:

```
use Fi1a\Validation\AbstractRuleSet;

/**
 * Набор правил
 */
class UserRuleSet extends AbstractRuleSet
{
    /**
     * @inheritDoc
     */
    public function init(): bool
    {
        $this->fields('id', 'email', 'tags', 'tags:*:id')
            ->on('create', 'copy')
            ->allOf()
            ->required();
        $this->fields('id', 'email', 'tags', 'tags:*:id')
            ->on('update')
            ->allOf()
            ->requiredIfPresence();

        $this->fields('id')->allOf()->integer();
        $this->fields('email')->allOf()->email();
        $this->fields('tags')->allOf()->array();
        $this->fields('tags:*:id')->allOf()->numeric();
        if ($this->getValue('password')->isPresence() || $this->getScenario() === 'create') {
            $this->fields('password')->allOf()->required()->minLength(8);
            $this->fields('confirm_password')->allOf()->required()->same('password');
        }

        return true;
    }

    /**
     * @inheritDoc
     */
    public function getMessages(): array
    {
        return array_merge(parent::getMessages(), [
            'tags|required' => 'Укажите хотябы один {{name}}',
        ]);
    }

    /**
     * @inheritDoc
     */
    public function getTitles(): array
    {
        return array_merge(parent::getTitles(), [
            'tags' => 'тег',
        ]);
    }
}
```

Использование набора правил по сценарию `create`:

```
use Fi1a\Validation\Validator;

$validator = new Validator();

$validation = $validator->make(new UserRuleSet($_POST + $_FILES), [], [], [], 'create');

$result = $validation->validate();

if (!$result->isSuccess()) {
    echo $result->getErrors()->join("\n");
}
```

Значение присутствует для валидации (проверки)
----------------------------------------------

[](#значение-присутствует-для-валидации-проверки)

По умолчанию большинство правил при валидации (проверке) возвращают `true`, если значение не присутсвует (за исключением `require()`). Класс, реализующий интерфейс `Fi1a\Validation\Presence\WhenPresenceInterface`, определяет по какому критерию будет происходить проверка на присутсвие значения.

Доступны следующие классы:

- `Fi1a\Validation\Presence\WhenPresence` - определяет присутствие значения по наличию ключа;
- `Fi1a\Validation\Presence\WhenNotValue` - определяет по переданному значению присутсвует значение или нет (если равно считается, что не присутсвует);
- `Fi1a\Validation\Presence\WhenNotNull` - определяет по значению null присутсвует значение или нет (если null считается, что не присутсвует);
- `Fi1a\Validation\Presence\WhenNotIn` - определяет по переданным значениям присутсвует значение или нет (если входит в значения считается, что не присутсвует);
- `Fi1a\Validation\Presence\WhenComposite` - используется как составной из других классов проверки присутсвия значения.

По умолчанию используется класс `Fi1a\Validation\Presence\WhenPresence`. Но вы можете передать нужный вам.

```
use Fi1a\Validation\AllOf;
use Fi1a\Validation\Presence\WhenNotNull;

$chain = AllOf::create()->boolean(new WhenNotNull());

$chain->validate(null)->isSuccess(); // true
$chain->validate(true)->isSuccess(); // true
$chain->validate('not-boolean')->isSuccess(); // false
```

Объект, определяющий присутсвие значения, можно установить сразу для всех правил используя метод `setPresence`:

```
use Fi1a\Validation\Presence\WhenNotNull;
use Fi1a\Validation\Validator;

$validator = new Validator();

$validation = $validator->make(
    [
        'array' => [null, 2, 3],
    ],
    [
        'array' => 'array|minCount(1)',
        'array:*' => 'integer',
    ]
);

$validation->setPresence(new WhenNotNull());

$result = $validation->validate();
$result->isSuccess(); // true
```

Правила
-------

[](#правила)

### alphaNumeric(?WhenPresenceInterface $presence = null)

[](#alphanumericwhenpresenceinterface-presence--null)

Значение должно быть буквенно-цифровым

```
use Fi1a\Validation\AllOf;

AllOf::create()->alphaNumeric()->validate('123abc')->isSuccess(); // true
AllOf::create()->alphaNumeric()->validate('abc 123')->isSuccess(); // false
```

### alpha(?WhenPresenceInterface $presence = null)

[](#alphawhenpresenceinterface-presence--null)

Является ли значение только буквенным(без чисел)

```
use Fi1a\Validation\AllOf;

AllOf::create()->alpha()->validate('abc')->isSuccess(); // true
AllOf::create()->alpha()->validate('abc100')->isSuccess(); // false
```

### array(?WhenPresenceInterface $presence = null)

[](#arraywhenpresenceinterface-presence--null)

Является ли значение массивом

```
use Fi1a\Validation\AllOf;

AllOf::create()->array()->validate([1, 2, 3])->isSuccess(); // true
AllOf::create()->array()->validate(false)->isSuccess(); // false
```

### betweenCount(int $min, int $max, ?WhenPresenceInterface $presence = null)

[](#betweencountint-min-int-max-whenpresenceinterface-presence--null)

Проверка на минимальное и максимальное количество элементов в массиве

```
use Fi1a\Validation\AllOf;

AllOf::create()->betweenCount(2, 5)->validate([1, 2, 3])->isSuccess(); // true
AllOf::create()->betweenCount(2, 5)->validate(3000000)->isSuccess(); // false
AllOf::create()->betweenCount(2, 5)->validate([1,])->isSuccess(); // false
```

### betweenDate(string $minDate, string $maxDate, ?string $format = null, ?WhenPresenceInterface $presence = null)

[](#betweendatestring-mindate-string-maxdate-string-format--null-whenpresenceinterface-presence--null)

Проверка на максимальную и минимальную дату

```
use Fi1a\Validation\AllOf;

AllOf::create()
    ->betweenDate('10.10.2022 10:10:10', '12.10.2022 10:10:10')
    ->validate('11.10.2022 10:10:10')
    ->isSuccess(); // true

AllOf::create()
    ->betweenDate('10.10.2022 10:10:10', '12.10.2022 10:10:10')
    ->validate('10.10.2022 09:00:00')
    ->isSuccess(); // false

AllOf::create()
    ->betweenDate('10.10.2022', '12.10.2022', 'd.m.Y')
    ->validate('11.10.2022')
    ->isSuccess(); // true
```

### betweenLength(int $min, int $max, ?WhenPresenceInterface $presence = null)

[](#betweenlengthint-min-int-max-whenpresenceinterface-presence--null)

Проверка на максимальную и минимальную длину строки

```
use Fi1a\Validation\AllOf;

AllOf::create()->betweenLength(2, 5)->validate(150)->isSuccess(); // true
AllOf::create()->betweenLength(2, 5)->validate(3000000)->isSuccess(); // false
AllOf::create()->betweenLength(2, 5)->validate('abc def gh')->isSuccess(); // false
```

### between($min, $max, ?WhenPresenceInterface $presence = null)

[](#betweenmin-max-whenpresenceinterface-presence--null)

Проверка на максимальное и мимальное значение

```
use Fi1a\Validation\AllOf;

AllOf::create()->between(100, 200)->validate(150)->isSuccess(); // true
AllOf::create()->between(100, 200)->validate(300)->isSuccess(); // false
AllOf::create()->between(100, 200)->validate('abc')->isSuccess(); // false
```

### boolean(?WhenPresenceInterface $presence = null)

[](#booleanwhenpresenceinterface-presence--null)

Является ли значение логическим

```
use Fi1a\Validation\AllOf;

AllOf::create()->boolean()->validate(true)->isSuccess(); // true
AllOf::create()->boolean()->validate(false)->isSuccess(); // true
AllOf::create()->boolean()->validate('TRUE')->isSuccess(); // true
AllOf::create()->boolean()->validate('FALSE')->isSuccess(); // true
AllOf::create()->boolean()->validate('0')->isSuccess(); // true
AllOf::create()->boolean()->validate('1')->isSuccess(); // true
AllOf::create()->boolean()->validate(0)->isSuccess(); // true
AllOf::create()->boolean()->validate(1)->isSuccess(); // true
AllOf::create()->boolean()->validate('Y')->isSuccess(); // true
AllOf::create()->boolean()->validate('N')->isSuccess(); // true
AllOf::create()->boolean()->validate(100)->isSuccess(); // false
AllOf::create()->boolean()->validate('abc')->isSuccess(); // false
```

### date(string $format = null, ?WhenPresenceInterface $presence = null)

[](#datestring-format--null-whenpresenceinterface-presence--null)

Проверка на формат даты

```
use Fi1a\Validation\AllOf;

AllOf::create()->date()->validate('10.10.2022')->isSuccess(); // true
AllOf::create()->date('d')->validate('10.10.2022')->isSuccess(); // false
AllOf::create()->date('d m, Y')->validate('10 10, 2022')->isSuccess(); // true
AllOf::create()->date()->validate('abc')->isSuccess(); // false
```

### email(?WhenPresenceInterface $presence = null)

[](#emailwhenpresenceinterface-presence--null)

Является ли значение email адресом

```
use Fi1a\Validation\AllOf;

AllOf::create()->email()->validate('foo@bar.ru')->isSuccess(); // true
AllOf::create()->email()->validate('foo')->isSuccess(); // false
```

### equalDate(string $equalDate, ?string $format = null, ?WhenPresenceInterface $presence = null)

[](#equaldatestring-equaldate-string-format--null-whenpresenceinterface-presence--null)

Проверяет дату на равенство

```
use Fi1a\Validation\AllOf;

AllOf::create()->equalDate('10.10.2022 10:10:10')->validate('10.10.2022 10:10:10')->isSuccess(); // true
AllOf::create()->equalDate('10.10.2022 10:10:10')->validate('10.10.2022 09:00:00')->isSuccess(); // false
AllOf::create()->equalDate('10.10.2022', 'd.m.Y')->validate('10.10.2022')->isSuccess(); // true
```

### equal(float $equal, ?WhenPresenceInterface $presence = null)

[](#equalfloat-equal-whenpresenceinterface-presence--null)

Проверяет число на равенство

```
use Fi1a\Validation\AllOf;

AllOf::create()->equal(100)->validate(100)->isSuccess(); // true
AllOf::create()->equal(100)->validate(200)->isSuccess(); // false
```

### fileSize(string $min, string $max, ?WhenPresenceInterface $presence = null)

[](#filesizestring-min-string-max-whenpresenceinterface-presence--null)

Размер загруженного файла.

Указатели на размер:

- B - байты;
- KB, K - килобайты;
- MB, M - мегабайты;
- GB, G - гигабайты;
- TB, T - террабайты;
- PB, P - петабайты.

```
use Fi1a\Validation\Validator;

$validator = new Validator();

$validation = $validator->make($_POST + $_FILES, [
    'photo' => 'required|fileSize("0", "1MB")',
]);

$result = $validation->validate();

if (!$result->isSuccess()) {
    echo $result->getErrors()->join("\n");
}
```

### generic(array $rules, array $messages = \[\], array $titles = \[\], ?WhenPresenceInterface $presence = null)

[](#genericarray-rules-array-messages---array-titles---whenpresenceinterface-presence--null)

Вложенные правила

```
use Fi1a\Validation\Validator;

$validator = new Validator();
$validation = $validator->make(
    [
        'columns' => [
            [
                'foo' => null,
            ],
            [
                'foo' => [
                    'bar' => 'baz'
                ],
            ],
        ],
    ],
    [
        'columns' => AllOf::create()->array(),
        'columns:*:foo' => AllOf::create()->generic(['bar' => 'required']),
    ]
);
$validation->validate()->isSuccess(); // true

$validator = new Validator();
$validation = $validator->make(
    [
        'columns' => [
            [
                'foo' => [],
            ],
            [
                'foo' => [
                    'bar' => 'baz'
                ],
            ],
        ],
    ],
    [
        'columns' => AllOf::create()->array(),
        'columns:*:foo' => AllOf::create()->generic(['bar' => 'required']),
    ]
);
$validation->validate()->isSuccess(); // false
```

### url(?WhenPresenceInterface $presence = null)

[](#urlwhenpresenceinterface-presence--null)

Валидация (проверка) url адреса

```
use Fi1a\Validation\AllOf;

AllOf::create()->url()->validate('https://domain.ru/path/')->isSuccess(); // true
AllOf::create()->url()->validate('https')->isSuccess(); // false
```

### in($presence, ...$in)

[](#inpresence-in)

Допустимые значения (не строгая проверка значения)

```
use Fi1a\Validation\AllOf;

AllOf::create()->in(1, 2, 3)->validate(1)->isSuccess(); // true
AllOf::create()->in(1, 2, 3)->validate(100.1)->isSuccess(); // false
AllOf::create()->in('camelCase', 'UPPERCASE')->validate('uppercase')->isSuccess(); // true
```

### integer(?WhenPresenceInterface $presence = null)

[](#integerwhenpresenceinterface-presence--null)

Является ли значение целым числом

```
use Fi1a\Validation\AllOf;

AllOf::create()->integer()->validate(1)->isSuccess(); // true
AllOf::create()->integer()->validate(100.1)->isSuccess(); // false
```

### json(?WhenPresenceInterface $presence = null)

[](#jsonwhenpresenceinterface-presence--null)

Является ли значение json-строкой

```
use Fi1a\Validation\AllOf;

AllOf::create()->json()->validate(json_encode([1, 2, 3]))->isSuccess(); // true
AllOf::create()->json()->validate('{')->isSuccess(); // false
```

### maxCount(int $max, ?WhenPresenceInterface $presence = null)

[](#maxcountint-max-whenpresenceinterface-presence--null)

Проверка на максимальное количество элементов в массиве

```
use Fi1a\Validation\AllOf;

AllOf::create()->maxCount(2)->validate([1,])->isSuccess(); // true
AllOf::create()->maxCount(2)->validate(100)->isSuccess(); // false
AllOf::create()->maxCount(2)->validate([1, 2, 3])->isSuccess(); // false
```

### maxDate(string $maxDate, ?string $format = null, ?WhenPresenceInterface $presence = null)

[](#maxdatestring-maxdate-string-format--null-whenpresenceinterface-presence--null)

Проверка на максимальную дату

```
use Fi1a\Validation\AllOf;

AllOf::create()->maxDate('10.10.2022 11:10:10')->validate('10.10.2022 10:10:10')->isSuccess(); // true
AllOf::create()->maxDate('10.10.2022 10:10:10')->validate('10.10.2022 12:00:00')->isSuccess(); // false
AllOf::create()->maxDate('10.10.2022', 'd.m.Y')->validate('09.10.2022')->isSuccess(); // true
```

### maxLength(int $max, ?WhenPresenceInterface $presence = null)

[](#maxlengthint-max-whenpresenceinterface-presence--null)

Проверка на максимальную длину строки

```
use Fi1a\Validation\AllOf;

AllOf::create()->maxLength(5)->validate('123')->isSuccess(); // true
AllOf::create()->maxLength(5)->validate(123)->isSuccess(); // true
AllOf::create()->maxLength(5)->validate(1000000)->isSuccess(); // false
AllOf::create()->maxLength(5)->validate('abc def h')->isSuccess(); // false
```

### max($max, ?WhenPresenceInterface $presence = null)

[](#maxmax-whenpresenceinterface-presence--null)

Проверка на максимальное значение

```
use Fi1a\Validation\AllOf;

AllOf::create()->max(100)->validate(50)->isSuccess(); // true
AllOf::create()->max(200)->validate(300)->isSuccess(); // false
AllOf::create()->max(200)->validate('abc')->isSuccess(); // false
```

### mime(WhenPresenceInterface|string $presence, string ...$extensions)

[](#mimewhenpresenceinterfacestring-presence-string-extensions)

Тип загруженного файла

```
use Fi1a\Validation\Validator;

$validator = new Validator();

$validation = $validator->make($_POST + $_FILES, [
    'photo' => 'fileSize("0", "1MB")|mime("jpeg", "png")',
]);

$result = $validation->validate();

if (!$result->isSuccess()) {
    echo $result->getErrors()->join("\n");
}
```

### minCount(int $min, ?WhenPresenceInterface $presence = null)

[](#mincountint-min-whenpresenceinterface-presence--null)

Проверка на минимальное количество элементов в массиве

```
use Fi1a\Validation\AllOf;

AllOf::create()->minCount(2)->validate([1, 2, 3])->isSuccess(); // true
AllOf::create()->minCount(2)->validate(100)->isSuccess(); // false
AllOf::create()->minCount(2)->validate([1])->isSuccess(); // false
```

### minDate(string $minDate, ?string $format = null, ?WhenPresenceInterface $presence = null)

[](#mindatestring-mindate-string-format--null-whenpresenceinterface-presence--null)

Проверка на минимальную дату

```
use Fi1a\Validation\AllOf;

AllOf::create()->minDate('10.10.2022 10:10:10')->validate('10.10.2022 10:10:10')->isSuccess(); // true
AllOf::create()->minDate('10.10.2022 10:10:10')->validate('10.10.2022 09:00:00')->isSuccess(); // false
AllOf::create()->minDate('10.10.2022', 'd.m.Y')->validate('10.10.2022')->isSuccess(); // true
```

### minLength(int $min, ?WhenPresenceInterface $presence = null)

[](#minlengthint-min-whenpresenceinterface-presence--null)

Проверка на минимальную длину строки

```
use Fi1a\Validation\AllOf;

AllOf::create()->minLength(5)->validate('123456')->isSuccess(); // true
AllOf::create()->minLength(5)->validate(123456)->isSuccess(); // true
AllOf::create()->minLength(5)->validate(100)->isSuccess(); // false
AllOf::create()->minLength(5)->validate('abc')->isSuccess(); // false
```

### min($min, ?WhenPresenceInterface $presence = null)

[](#minmin-whenpresenceinterface-presence--null)

Проверка на минимальное значение

```
use Fi1a\Validation\AllOf;

AllOf::create()->min(100)->validate(200)->isSuccess(); // true
AllOf::create()->min(200)->validate(100)->isSuccess(); // false
AllOf::create()->min(200)->validate('abc')->isSuccess(); // false
```

### notIn($presence, ...$notIn)

[](#notinpresence-notin)

Не допустимые значения (не строгая проверка значения)

```
use Fi1a\Validation\AllOf;

AllOf::create()->notIn(1, 2, 3)->validate(4)->isSuccess(); // true
AllOf::create()->notIn(1, 2, 3)->validate(2)->isSuccess(); // false
AllOf::create()->notIn('camelCase', 'UPPERCASE')->validate('uppercase')->isSuccess(); // false
```

### null(?WhenPresenceInterface $presence = null)

[](#nullwhenpresenceinterface-presence--null)

Является ли значение null

```
use Fi1a\Validation\AllOf;

AllOf::create()->null()->validate(null)->isSuccess(); // true
AllOf::create()->null()->validate(false)->isSuccess(); // false
```

### numeric(?WhenPresenceInterface $presence = null)

[](#numericwhenpresenceinterface-presence--null)

Является ли значение числом

```
use Fi1a\Validation\AllOf;

AllOf::create()->numeric()->validate(1)->isSuccess(); // true
AllOf::create()->numeric()->validate(false)->isSuccess(); // false
```

### regex(string $regex, ?WhenPresenceInterface $presence = null)

[](#regexstring-regex-whenpresenceinterface-presence--null)

Проверка на регулярное выражение

```
use Fi1a\Validation\AllOf;

AllOf::create()->regex('/[0-9]/mui')->validate(200)->isSuccess(); // true
AllOf::create()->regex('/[0-9]/mui')->validate('abc')->isSuccess(); // false
```

### requiredIfPresence(?WhenPresenceInterface $presence = null)

[](#requiredifpresencewhenpresenceinterface-presence--null)

Обязательное значение, если передано

```
use Fi1a\Validation\Validator;

$validator = new Validator();
$validation = $validator->make(['foo' => true], ['foo' => 'requiredIfPresence']);

$validation->validate()->isSuccess(); // true

$validation->setValues(['foo' => null]);
$validation->validate()->isSuccess(); // false

$validation->setValues([]);
$validation->validate()->isSuccess(); // true
```

### required()

[](#required)

Обязательное значение

```
use Fi1a\Validation\AllOf;

AllOf::create()->required()->validate(true)->isSuccess(); // true
AllOf::create()->required()->validate(null)->isSuccess(); // false
```

### requiredWith(string ...$fieldNames)

[](#requiredwithstring-fieldnames)

Обязательное значение, если есть значения в полях

```
use Fi1a\Validation\AllOf;

AllOf::create()
    ->requiredWith('array:foo', 'array:bar')
    ->validate(['array' => ['foo' => 'foo', 'bar' => 'bar'], 'baz' => 'baz'], 'baz')
    ->isSuccess(); // true

AllOf::create()
    ->requiredWith('array:foo', 'array:bar')
    ->validate(['array' => ['foo' => 'foo', 'bar' => null], 'baz' => null], 'baz')
    ->isSuccess(); // true

AllOf::create()
    ->requiredWith('array:foo', 'array:bar')
    ->validate(['array' => ['foo' => 'foo', 'bar' => 'bar'], 'baz' => null], 'baz')
    ->isSuccess(); // false
```

### same(string $fieldName, ?WhenPresenceInterface $presence = null)

[](#samestring-fieldname-whenpresenceinterface-presence--null)

Совпадает ли значение со значением в указанном поле

```
use Fi1a\Validation\AllOf;

AllOf::create()->same('field1')->validate(200)->isSuccess(); // false
AllOf::create()->same('bar')->validate(['foo' => 200, 'bar' => 200], 'foo')->isSuccess(); // true
```

### strictIn($presence, ...$in)

[](#strictinpresence-in)

Допустимые значения (строгая проверка значения)

```
use Fi1a\Validation\AllOf;

AllOf::create()->strictIn(1, 2, 3)->validate(1)->isSuccess(); // true
AllOf::create()->strictIn(1, 2, 3)->validate(100.1)->isSuccess(); // false
AllOf::create()->strictIn('camelCase', 'UPPERCASE')->validate('uppercase')->isSuccess(); // false
```

### strictNotIn($presence, ...$notIn)

[](#strictnotinpresence-notin)

Не допустимые значения (строгая проверка значения)

```
use Fi1a\Validation\AllOf;

AllOf::create()->strictNotIn(1, 2, 3)->validate(4)->isSuccess(); // true
AllOf::create()->strictNotIn(1, 2, 3)->validate(2)->isSuccess(); // false
AllOf::create()->strictNotIn('camelCase', 'UPPERCASE')->validate('uppercase')->isSuccess(); // true
```

### string(?WhenPresenceInterface $presence = null)

[](#stringwhenpresenceinterface-presence--null)

Является ли значение строкой

```
use Fi1a\Validation\AllOf;

AllOf::create()->string()->validate('foo')->isSuccess(); // true
AllOf::create()->string()->validate(false)->isSuccess(); // false
```

Пользовательское правило проверки
---------------------------------

[](#пользовательское-правило-проверки)

В библиотеки есть возможность расширить доступные правила проверки. Правило проверки должно реализовывать интерфейс `\Fi1a\Validation\Rule\RuleInterface`.

Пример реализации пользовательского правила проверки:

```
use \Fi1a\Validation\Rule\AbstractRule;
use \Fi1a\Validation\ValueInterface;

/**
 * Проверка на уникальное значение
 */
class UniqueRule extends AbstractRule
{
    /**
     * @var Bitrix\Main\ORM\Data\DataManager
     */
    private $className;

    /**
     * @var string
     */
    private $column;

    /**
     * @var int|null
     */
    private $notId;

    /**
     * Конструктор
     */
    public function __construct(string $className, string $column, ?int $notId = null, ?WhenPresenceInterface $presence = null)
    {
        $this->className = $className;
        $this->column = $column;
        $this->notId = $notId;
        parent::__construct($presence);
    }

    /**
     * @inheritDoc
     */
    public function validate(ValueInterface $value): bool
    {
        if (!$value->isPresence()) {
            return true;
        }
        $filter = [
            $this->column => $value->getValue(),
        ];
        if ($this->notId) {
            $filter['!ID'] = $this->notId;
        }
        $success = $this->className::getCount($filter) === 0;

        if (!$success) {
            $this->addMessage('Значение {{if(name)}}"{{name}}" {{endif}}не является уникальным', 'unique');
        }

        return $success;
    }

    /**
     * @inheritDoc
     */
    public static function getRuleName(): string
    {
        return 'unique';
    }
}
```

Зарегистрируем пользовательское правило в классе валидатора с помощью метода `addRule`:

```
\Fi1a\Validation\Validator::addRule(UniqueRule::class);
```

И можно использовать пользовательское правило проверки:

```
use \Fi1a\Validation\AllOf;
use \Bitrix\Main\UserTable;

$unique = AllOf::create()->unique(UserTable::class, 'LOGIN');
$unique->validate('admin')->isSuccess(); // false
$unique->validate('user')->isSuccess(); // true
```

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~9 days

Recently: every ~1 days

Total

17

Last Release

1210d ago

Major Versions

1.0.5 → 2.0.x-dev2022-12-04

2.0.0 → 3.0.02023-01-09

### Community

Maintainers

![](https://www.gravatar.com/avatar/d4f26c1adaa632741fadf55b1328cbd22ac91282aecfae2027d105df0ddedee4?d=identicon)[fi1a](/maintainers/fi1a)

---

Top Contributors

[![fi1a](https://avatars.githubusercontent.com/u/18556038?v=4)](https://github.com/fi1a "fi1a (11 commits)")

---

Tags

phpvalidationvalidator

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/fi1a-validation/health.svg)

```
[![Health](https://phpackages.com/badges/fi1a-validation/health.svg)](https://phpackages.com/packages/fi1a-validation)
```

###  Alternatives

[marcosh/php-validation-dsl

A DSL for validating data in a functional fashion

483.9k](/packages/marcosh-php-validation-dsl)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)