Разработка ORM-сущностей 1С-Битрикс D7 под ключ

Разработка ORM-сущностей 1С-Битрикс D7

Мы более 10 лет работаем с 1С-Битрикс и видим, как много проектов страдает от каши в базе данных: сырые SQL-запросы в компонентах, дублирование логики, отсутствие типов. ORM D7 — инструмент, который превращает хаос в порядок. DataManager-сущность описывает таблицу, её поля и связи, а вместо $DB->Query вы пишете MyTable::getList([...]). За 10+ лет мы реализовали 50+ проектов на ORM D7 — от небольших кастомных модулей до полной замены legacy-схем в каталогах с миллионами записей.

Почему ORM D7 выгоднее сырых SQL-запросов?

Прямые SQL-запросы через $DB->Query — прошлый век. Они тяжело поддерживаются, не дают типизированных объектов и не интегрируются с кэшем Битрикс. ORM D7 решает все эти проблемы: код становится читаемым, безопасным (экранирование автоматически), а скорость разработки растёт в 2–3 раза. Кроме того, ORM-сущности умеют работать с тегированным кэшем, который сбрасывается только при изменении данных, а не по таймеру. Это особенно важно на высоконагруженных проектах.

Базовая структура DataManager

Минимальная сущность выглядит так:

namespace MyProject\Storage;

use Bitrix\Main\ORM\Data\DataManager;
use Bitrix\Main\ORM\Fields\IntegerField;
use Bitrix\Main\ORM\Fields\StringField;
use Bitrix\Main\ORM\Fields\DatetimeField;

class OrderLogTable extends DataManager
{
    public static function getTableName(): string
    {
        return 'my_order_log';
    }

    public static function getMap(): array
    {
        return [
            new IntegerField('ID', [
                'primary'      => true,
                'autocomplete' => true,
            ]),
            new IntegerField('ORDER_ID', [
                'required' => true,
            ]),
            new StringField('ACTION', [
                'required'  => true,
                'size'      => 100,
            ]),
            new DatetimeField('CREATED_AT', [
                'default_value' => new \Bitrix\Main\Type\DateTime(),
            ]),
        ];
    }
}

Класс регистрируется в autoload-карте модуля или через PSR-4 в composer.json внутри /local/.

Типы полей ORM

Для валидации полей используется параметр validation.

Как правильно описать связи в DataManager?

Один-ко-многим (Reference) описывается через Reference с указанием класса целевой сущности и условия Join. После описания связи в запросе вы получаете данные joined-таблицы.

$result = OrderLogTable::getList([
    'select' => ['ID', 'ACTION', 'ORDER_.USER_ID', 'ORDER_.DATE_INSERT'],
    'filter' => ['ORDER_ID' => 42],
]);

Создание таблицы: миграции

Таблицу создаёт метод createDbTable() класса сущности. Для изменения структуры — DDL-запросы через Application::getConnection(). Битрикс не имеет встроенного механизма миграций — для продакшн-проектов это решается собственным скриптом-мигратором.

ORM-запросы: основные операции

Выборка с условиями:

$result = OrderLogTable::getList([
    'select' => ['ID', 'ORDER_ID', 'ACTION', 'CREATED_AT'],
    'filter' => [
        '>CREATED_AT' => new \Bitrix\Main\Type\DateTime('-7 days'),
        'ACTION'      => 'STATUS_CHANGED',
    ],
    'order'  => ['CREATED_AT' => 'DESC'],
    'limit'  => 50,
]);
while ($row = $result->fetch()) { }

Добавление, обновление и удаление выполняются через методы add(), update(), delete(). ORM автоматически проверяет типы и экранирует значения.

Кеширование запросов

ORM интегрируется с кешем Битрикс:

$result = OrderLogTable::getList([
    'select' => ['ID', 'ACTION'],
    'filter' => ['ORDER_ID' => 42],
    'cache'  => ['ttl' => 3600, 'cache_joins' => true],
]);

Кеш сбрасывается автоматически при изменении данных через ORM-методы (если включён управляемый кеш).

Сроки

DataManager-сущности — это инвестиция в читаемость и поддерживаемость кода. Через год разработчик, не писавший этот код, разберётся в схеме БД за час, а не за день. При работе с сырым SQL такой гарантии нет.

Что входит в работу

• Документация по схеме БД — описание таблиц, полей, связей и индексов.
• Исходный код сущностей — классы DataManager с валидацией и событиями.
• Скрипты миграции — для создания и изменения таблиц, переноса данных.
• Инструкция по развёртыванию — порядок установки модуля и обновлений.
• Поддержка 2 недели после сдачи — исправление ошибок, консультации.

$conn = \Bitrix\Main\Application::getConnection();
$conn->query("ALTER TABLE my_order_log ADD COLUMN CONTEXT TEXT DEFAULT NULL");
$conn->query("CREATE INDEX idx_order_log_created ON my_order_log (CREATED_AT)");

Типичные ошибки при работе с ORM D7

• Отсутствие индексов — запросы тормозят на объёмах от 100 000 строк.
• Неправильные типы полей — например, StringField вместо TextField, что режет данные.
• Игнорирование кэширования — каждый запрос бьёт в БД, хотя данные редко меняются.
• Отказ от связей — ручная подгрузка связанных записей ведёт к N+1 запросу.

Избегаем этих граблей за счёт ревью кода и нагрузочного тестирования.

Как мы внедряем ORM-сущности: реальный кейс

Один из проектов — интернет-магазин с каталогом на 300 000 товаров. Изначально все выборки делались через CIBlockElement::GetList с кучей параметров. Производительность упала, страницы грузились по 5 секунд. Мы разработали ORM-слой для торговых предложений, скидок и остатков. Результат: время генерации страницы списка сократилось до 0,8 секунды, а сложный фильтр стал обрабатываться за 0,3 секунды. Дополнительно подключили тегированное кэширование, и количество запросов к БД упало в 4 раза. В среднем экономия бюджета на поддержке таких проектов составляет 30–50%.

Процесс работы

1. Аналитика — изучаем структуру текущей БД, бизнес-требования и нагрузки.
2. Проектирование — рисуем схему ORM-сущностей, определяем связи и индексы.
3. Реализация — пишем код сущностей, методы CRUD, события и кэширование.
4. Тестирование — юнит-тесты, нагрузочное тестирование с реальными объёмами.
5. Деплой — применяем миграции, обновляем доступы, передаём документацию.

Свяжитесь с нами, чтобы обсудить ваш проект. Оценим сложность и предложим сроки без лишних обязательств. Закажите консультацию уже сегодня.

Подробнее об ORM читайте в Wikipedia и официальной документации 1С-Битрикс (dev.1c-bitrix.ru).