LengthValidator — проверка длины значения поля ORM
Пространство имен: Bitrix\Main\ORM\Fields\Validators
Модуль: main — подключать отдельно не нужно
Доступно с версии: 14.0.5
Когда использовать
Валидатор LengthValidator проверяет длину значения поля в символах перед записью через ORM. Валидатор подключают к полю в методе getMap, например методом addValidator поля. Если длина не подходит, операция add или update возвращает ошибку и не записывает данные.
Старое имя класса Bitrix\Main\Entity\Validator\Length работает как псевдоним.
Методы класса
| Метод | Описание | С версии |
|---|---|---|
| validate | Проверяет длину значения | |
| getMin | Возвращает минимальную длину | 14.9.4 |
| getMax | Возвращает максимальную длину | 14.9.4 |
Наследование
Класс наследует Bitrix\Main\ORM\Fields\Validators\Validator.
Реализация методов базового класса
|
Метод |
Особенность реализации |
|
|
Принимает минимальную и максимальную длину и тексты ошибок:
Если |
Примеры
Пример. Код подключает к полю CODE валидатор длины от одного до пяти символов и выводит число валидаторов поля:
<?php
use Bitrix\Main\ORM\Fields\StringField;
use Bitrix\Main\ORM\Fields\Validators\LengthValidator;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$field =
(new StringField('CODE'))
->addValidator(new LengthValidator(1, 5))
;
echo count($field->getValidators());
Код выведет 1.