HandlerTable::add()
Сигнатура
public static add(array<string|int, mixed> $data) : AddResult
Описание
Добавляет строку в таблицу сущности
Параметры
$data
array<string|int, mixed>
Возвращаемое значение
AddResult
Как применяется в HandlerTable
HandlerTable::add() — метод класса \Bitrix\Main\Service\GeoIp\HandlerTable модуля «Главный модуль». Это ORM-сущность D7 (наследник DataManager): строки читаются как объекты EO_Handler, наборы — как EO_Handler_Collection. Метод достаётся HandlerTable от DataManager::add: поведение общее для всех сущностей, а данные, поля и классы — свои.
Добавляет строку в таблицу HandlerTable. Перед записью ORM проверяет поля (checkFields()) и вызывает события; ошибки возвращаются в результате, исключения не бросаются.
use Bitrix\Main\Service\GeoIp\HandlerTable;
$result = HandlerTable::add([
'SORT' => 1,
'ACTIVE' => 'Y',
'CLASS_NAME' => 'class_name',
]);
if ($result->isSuccess()) {
$id = $result->getId();
} else {
$errors = $result->getErrorMessages();
}Поля сущности HandlerTable
| Поле | Тип | Свойства |
|---|---|---|
ID | int | обязательное |
SORT | int | необязательное, по умолчанию 100 |
ACTIVE | bool | необязательное, по умолчанию 'Y' |
CLASS_NAME | string(255) | обязательное |
CONFIG | string | необязательное |
Список — из описания класса в исходном коде; точный состав в вашей версии вернёт HandlerTable::getEntity()->getFields().
Собственные методы HandlerTable
validateClassName()Возвращает валидаторы для поля CLASS_NAME.
add() есть и у других классов модуля «Главный модуль»: AccessPermissionTable, AccessRoleRelationTable, AccessRoleTable, AddStrategy, ApplicationPasswordTable, CacheCleanPathTable, CacheTagTable, CacheTracker.
Исходный файл: source/main/lib/service/geoip/handler.php:877

