Интеграция Elasticsearch с 1С-Битрикс

Интеграция Elasticsearch с 1С-Битрикс

Встроенный поиск Битрикс опирается на таблицы b_search_content и b_search_content_stem — морфологический индекс на базе MySQL/MariaDB. При 50–100 тысячах проиндексированных документов полнотекстовые запросы начинают давать задержки от 200–500 мс. На каталогах с миллионом SKU или при необходимости сложных фильтраций в поиске (диапазон цены, несколько фасетов одновременно) встроенный поиск не справляется. Elasticsearch решает обе проблемы: выдаёт результаты за 5–30 мс и поддерживает произвольную агрегацию.

Архитектура интеграции

Интеграция состоит из трёх частей:

1. Индексатор — компонент, который читает данные из Битрикс (инфоблоки, пользователи, страницы) и записывает документы в индекс Elasticsearch.
2. Поисковый шлюз — заменяет стандартные запросы к b_search_content запросами к Elasticsearch API.
3. Обработчики событий — обновляют индекс при изменении или удалении сущностей.

Структура индекса для каталога товаров

Индекс создаётся через Elasticsearch Mapping API. Пример маппинга для товаров:

PUT /bitrix_catalog
{
  "mappings": {
    "properties": {
      "id":          { "type": "integer" },
      "iblock_id":   { "type": "integer" },
      "name":        { "type": "text", "analyzer": "russian" },
      "description": { "type": "text", "analyzer": "russian" },
      "sku":         { "type": "keyword" },
      "price":       { "type": "float" },
      "active":      { "type": "boolean" },
      "section_id":  { "type": "integer" },
      "properties":  { "type": "object" },
      "updated_at":  { "type": "date" }
    }
  },
  "settings": {
    "analysis": {
      "analyzer": {
        "russian": {
          "type": "custom",
          "tokenizer": "standard",
          "filter": ["lowercase", "russian_stop", "russian_stemmer"]
        }
      },
      "filter": {
        "russian_stemmer": { "type": "stemmer", "language": "russian" },
        "russian_stop":    { "type": "stop", "stopwords": "_russian_" }
      }
    }
  }
}

Анализатор russian с стеммером — ключевое отличие от MySQL FULLTEXT, который без дополнительных словарей не понимает морфологию.

Индексация данных

Первичная индексация запускается через cron-скрипт. Данные читаются пакетами через CIBlockElement::GetList() с nTopCount = 100 и смещением, чтобы не перегрузить память:

\Bitrix\Main\Loader::includeModule('iblock');

$client = new \Elasticsearch\ClientBuilder::create()
    ->setHosts(['localhost:9200'])
    ->build();

$offset = 0;
$batchSize = 100;

do {
    $res = \CIBlockElement::GetList(
        [],
        ['IBLOCK_ID' => CATALOG_IBLOCK_ID, 'ACTIVE' => 'Y'],
        false,
        ['nTopCount' => $batchSize, 'nPageSize' => $batchSize, 'iNumPage' => floor($offset / $batchSize) + 1],
        ['ID', 'NAME', 'DETAIL_TEXT', 'IBLOCK_ID', 'IBLOCK_SECTION_ID']
    );

    $bulk = [];
    while ($item = $res->GetNext()) {
        $bulk[] = ['index' => ['_index' => 'bitrix_catalog', '_id' => $item['ID']]];
        $bulk[] = [
            'id'         => (int)$item['ID'],
            'iblock_id'  => (int)$item['IBLOCK_ID'],
            'name'       => $item['NAME'],
            'description'=> strip_tags($item['DETAIL_TEXT']),
            'section_id' => (int)$item['IBLOCK_SECTION_ID'],
            'active'     => true,
            'updated_at' => date('c'),
        ];
        $offset++;
    }

    if (!empty($bulk)) {
        $client->bulk(['body' => $bulk]);
    }
} while ($res->SelectedRowsCount() === $batchSize);

Bulk API позволяет отправлять до 1000 документов за запрос. Не используйте индивидуальные index-запросы для первичной индексации — это в 10–50 раз медленнее.

Обновление индекса при изменении товара

Подписываемся на события инфоблока:

// local/php_interface/init.php
AddEventHandler('iblock', 'OnAfterIBlockElementUpdate', 'esUpdateProduct');
AddEventHandler('iblock', 'OnAfterIBlockElementDelete', 'esDeleteProduct');

function esUpdateProduct(array &$arFields): void
{
    $client = getEsClient();
    $productId = (int)$arFields['ID'];
    // Переиндексировать один документ
    $client->index([
        'index' => 'bitrix_catalog',
        'id'    => $productId,
        'body'  => buildProductDocument($productId),
    ]);
}

function esDeleteProduct(int $productId): void
{
    getEsClient()->delete(['index' => 'bitrix_catalog', 'id' => $productId]);
}

Событие OnAfterIBlockElementUpdate срабатывает и при изменении через API (импорт из 1С), что важно для актуальности индекса.

Поисковый запрос

Замена стандартного компонента bitrix:search.page на кастомный, обращающийся к Elasticsearch:

$response = $client->search([
    'index' => 'bitrix_catalog',
    'body'  => [
        'query' => [
            'multi_match' => [
                'query'     => $searchQuery,
                'fields'    => ['name^3', 'description', 'sku'],
                'type'      => 'best_fields',
                'fuzziness' => 'AUTO',
            ],
        ],
        'sort'  => ['_score' => ['order' => 'desc']],
        'from'  => ($page - 1) * $pageSize,
        'size'  => $pageSize,
    ],
]);

Параметр fuzziness: AUTO обеспечивает поиск с опечатками: для слов до 5 символов допускается 1 замена, для более длинных — 2.

Сроки внедрения