Валидация означает проверку данных, заполняемых пользователем. Пакет предоставляет возможность организовать проверку на стороне сервера после отправки данных формы.
- Проверка (валидация) данных массива и отдельного значения;
- Проверка (валидация) значений формы и загружаемых файлов;
- Поддержка набора правил со сценариями;
- Возможность изменить названия полей;
- Возможность изменить текст ошибки;
- Возможность расширить пользовательскими правилами проверки;
- Сценарии и наборы правил;
- Проверка публичных полей объекта.
Установить этот пакет можно как зависимость, используя 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
Значение должно быть буквенно-цифровым
use Fi1a\Validation\AllOf;
AllOf::create()->alphaNumeric()->validate('123abc')->isSuccess(); // true
AllOf::create()->alphaNumeric()->validate('abc 123')->isSuccess(); // false
Является ли значение только буквенным(без чисел)
use Fi1a\Validation\AllOf;
AllOf::create()->alpha()->validate('abc')->isSuccess(); // true
AllOf::create()->alpha()->validate('abc100')->isSuccess(); // false
Является ли значение массивом
use Fi1a\Validation\AllOf;
AllOf::create()->array()->validate([1, 2, 3])->isSuccess(); // true
AllOf::create()->array()->validate(false)->isSuccess(); // false
Проверка на минимальное и максимальное количество элементов в массиве
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)
Проверка на максимальную и минимальную дату
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
Проверка на максимальную и минимальную длину строки
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
Проверка на максимальное и мимальное значение
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
Является ли значение логическим
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
Проверка на формат даты
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 адресом
use Fi1a\Validation\AllOf;
AllOf::create()->email()->validate('[email protected]')->isSuccess(); // true
AllOf::create()->email()->validate('foo')->isSuccess(); // false
Проверяет дату на равенство
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
Проверяет число на равенство
use Fi1a\Validation\AllOf;
AllOf::create()->equal(100)->validate(100)->isSuccess(); // true
AllOf::create()->equal(100)->validate(200)->isSuccess(); // false
Размер загруженного файла.
Указатели на размер:
- 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)
Вложенные правила
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 адреса
use Fi1a\Validation\AllOf;
AllOf::create()->url()->validate('https://domain.ru/path/')->isSuccess(); // true
AllOf::create()->url()->validate('https')->isSuccess(); // false
Допустимые значения (не строгая проверка значения)
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
Является ли значение целым числом
use Fi1a\Validation\AllOf;
AllOf::create()->integer()->validate(1)->isSuccess(); // true
AllOf::create()->integer()->validate(100.1)->isSuccess(); // false
Является ли значение json-строкой
use Fi1a\Validation\AllOf;
AllOf::create()->json()->validate(json_encode([1, 2, 3]))->isSuccess(); // true
AllOf::create()->json()->validate('{')->isSuccess(); // false
Проверка на максимальное количество элементов в массиве
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
Проверка на максимальную дату
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
Проверка на максимальную длину строки
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
Проверка на максимальное значение
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
Тип загруженного файла
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");
}
Проверка на минимальное количество элементов в массиве
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
Проверка на минимальную дату
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
Проверка на минимальную длину строки
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
Проверка на минимальное значение
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
Не допустимые значения (не строгая проверка значения)
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
use Fi1a\Validation\AllOf;
AllOf::create()->null()->validate(null)->isSuccess(); // true
AllOf::create()->null()->validate(false)->isSuccess(); // false
Является ли значение числом
use Fi1a\Validation\AllOf;
AllOf::create()->numeric()->validate(1)->isSuccess(); // true
AllOf::create()->numeric()->validate(false)->isSuccess(); // false
Проверка на регулярное выражение
use Fi1a\Validation\AllOf;
AllOf::create()->regex('/[0-9]/mui')->validate(200)->isSuccess(); // true
AllOf::create()->regex('/[0-9]/mui')->validate('abc')->isSuccess(); // false
Обязательное значение, если передано
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
Обязательное значение
use Fi1a\Validation\AllOf;
AllOf::create()->required()->validate(true)->isSuccess(); // true
AllOf::create()->required()->validate(null)->isSuccess(); // false
Обязательное значение, если есть значения в полях
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
Совпадает ли значение со значением в указанном поле
use Fi1a\Validation\AllOf;
AllOf::create()->same('field1')->validate(200)->isSuccess(); // false
AllOf::create()->same('bar')->validate(['foo' => 200, 'bar' => 200], 'foo')->isSuccess(); // true
Допустимые значения (строгая проверка значения)
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
Не допустимые значения (строгая проверка значения)
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
Является ли значение строкой
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