Поиск по нескольким инфоблокам Битрикс чаще всего делают циклом: берут список ID, гоняют CIBlockElement::GetList по каждому инфоблоку и склеивают массивы. Если на сайте каталог, статьи, новости, услуги и вакансии лежат в разных инфоблоках, на каждый ввод в строке поиска уходит пять обращений к базе, а результаты потом приходится сортировать руками. Обойтись можно одним обращением. Ниже три рабочих способа, их ограничения и моё правило, когда какой брать.
Почему перебор инфоблоков в цикле путает выдачу
Типичный код, который я встречаю на проектах, пришедших на доработку, выглядит так:
$result = array();
foreach (array(2, 5, 7) as $iblockId) {
$res = CIBlockElement::GetList(
array('SORT' => 'ASC'),
array('IBLOCK_ID' => $iblockId, 'ACTIVE' => 'Y', '%NAME' => $query),
false,
array('nTopCount' => 20),
array('ID', 'IBLOCK_ID', 'NAME', 'DETAIL_PAGE_URL')
);
while ($item = $res->GetNext()) {
$result[] = $item;
}
}
Работает, пока инфоблоков два и элементов немного. Дальше начинаются проблемы, и все они вытекают из самой схемы.
- Число запросов растёт вместе с числом инфоблоков. Добавили раздел «Вакансии» и получили ещё один запрос на каждый поиск.
- Порядок выдачи получается по инфоблокам: сначала всё из первого, потом из второго. Общей сортировки по названию или по дате нет, пока не отсортируешь склеенный массив сам.
- Пагинация ломается. Чтобы показать вторую страницу общей выдачи, надо выгрузить все страницы каждого инфоблока и резать массив в PHP. Лимит
nTopCountв каждом цикле даёт «20 из каждого», а не «первые 20 всего». - Условия фильтра (активность, даты, права) приходится дублировать, и однажды они разъедутся: в одной ветке забудут
ACTIVE_DATE, и на сайте всплывёт материал с истёкшим сроком показа.
Всё это решается тем, что фильтр получает сразу все нужные инфоблоки и база отдаёт единый отсортированный список.
Выборка элементов из нескольких инфоблоков через CIBlockElement::GetList
В фильтре старого ядра ключ IBLOCK_ID принимает массив. Метод возвращает элементы всех перечисленных инфоблоков одним списком, с общей сортировкой и общим ограничением:
<?php
\Bitrix\Main\Loader::includeModule('iblock');
$query = trim($_GET['q'] ?? '');
$iblockIds = array(2, 5, 7);
if (mb_strlen($query) >= 3) {
$res = CIBlockElement::GetList(
array('SORT' => 'ASC', 'NAME' => 'ASC'),
array(
'IBLOCK_ID' => $iblockIds,
'ACTIVE' => 'Y',
'ACTIVE_DATE' => 'Y',
'CHECK_PERMISSIONS' => 'Y',
'%NAME' => $query,
),
false,
array('nTopCount' => 20),
array('ID', 'IBLOCK_ID', 'NAME', 'DETAIL_PAGE_URL')
);
$found = array();
while ($item = $res->GetNext()) {
$found[$item['IBLOCK_ID']][] = $item;
}
}
Что здесь важно. В выборке всегда стоят ID и IBLOCK_ID: документация прямо требует их для корректной работы, а IBLOCK_ID мне ещё нужен, чтобы сгруппировать результат по разделам сайта. Поле DETAIL_PAGE_URL собирается по шаблону адреса каждого инфоблока, поэтому ссылка на статью и ссылка на товар получаются разными без единой строки моего кода. Префикс % в фильтре ищет подстроку в названии. Минимальную длину запроса я ограничиваю тремя символами: подстрока из одной буквы вытащит половину базы.
Отдельно про три ключа. ACTIVE отсекает выключенные элементы, ACTIVE_DATE учитывает даты начала и окончания активности, CHECK_PERMISSIONS проверяет права текущего посетителя на инфоблок. Без последнего закрытый инфоблок с внутренними документами спокойно попадёт в публичную выдачу, если его ID оказался в массиве.
Счётчики по каждому инфоблоку одним запросом
Для вкладок вида «Каталог (12), Статьи (5)» количество по каждому инфоблоку считать отдельными запросами не нужно. Если в третьем параметре передать группировку по IBLOCK_ID, метод вернёт количество элементов CNT для каждого инфоблока:
$res = CIBlockElement::GetList(
array(),
array('IBLOCK_ID' => $iblockIds, 'ACTIVE' => 'Y', '%NAME' => $query),
array('IBLOCK_ID')
);
$counts = array();
while ($row = $res->Fetch()) {
$counts[$row['IBLOCK_ID']] = $row['CNT'];
}
В сумме получается два запроса на весь экран поиска: список и счётчики, независимо от числа инфоблоков.
Свойства в фильтре и выборке
Со свойствами всё сложнее. Ключи вида PROPERTY_КОД привязаны к конкретному свойству, а в разных инфоблоках коды часто различаются: у товара это ARTNUMBER, у статьи свойства с таким кодом вообще нет. Значения свойств в выборке приходят полями PROPERTY_КОД_VALUE, и код при этом задаётся в верхнем регистре. Поэтому в общий запрос по нескольким инфоблокам я беру только поля, которые есть у любого элемента: NAME, PREVIEW_TEXT, DETAIL_TEXT, CODE, раздел. Если для карточки в выдаче нужно свойство (цена, артикул), делаю второй запрос по конкретному инфоблоку и только по ID уже найденных элементов. Это два запроса вместо пяти, и код остаётся читаемым.
Бесплатный материал
🎁 Полезный скрипт в подарок
Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.
Без спама. Отписка в 1 клик.
Фильтр по нескольким IBLOCK_ID в D7: ElementTable
Оба ядра Битрикса живут в продукте одновременно, и D7 старые классы не отменяет. Для элементов инфоблока в D7 есть таблица ElementTable, ей удобно пользоваться там, где нужен чистый запрос без обвязки старого ядра:
<?php
use Bitrix\Main\Loader;
use Bitrix\Iblock\ElementTable;
Loader::includeModule('iblock');
$rows = ElementTable::getList(array(
'select' => array('ID', 'IBLOCK_ID', 'NAME', 'CODE'),
'filter' => array(
'@IBLOCK_ID' => array(2, 5, 7),
'=ACTIVE' => 'Y',
'%=NAME' => '%' . $query . '%',
),
'order' => array('NAME' => 'ASC'),
'limit' => 20,
))->fetchAll();
Оператор @ в фильтре работает как «значение входит в список». Префикс %= с процентами в самом значении ищет подстроку, это форма из документации по D7 ORM. Метод возвращает объект результата, данные забирают через fetch() или fetchAll().
Ограничения тут такие. ORM-таблица не считает адрес детальной страницы: DETAIL_PAGE_URL в ней нет, и ссылки придётся собирать самому по шаблону из настроек инфоблока. Проверку прав и дат активности ORM тоже не делает, их надо писать в фильтре явно. Поэтому для публичной выдачи на сайте я чаще оставляю CIBlockElement::GetList, а ElementTable беру для служебных выборок: выгрузок, агентов, проверок дублей по названию во всех инфоблоках сразу.
Поиск по разным инфоблокам через модуль search
Фильтр по подстроке в названии хорошо работает для строки поиска в админке или подсказок по артикулу. Для посетителя, который вводит «кабель для роутера» и ждёт релевантной выдачи, этого мало: подстрока не знает про склонения, не ранжирует и не ищет по тексту статьи. Здесь нужен штатный модуль «Поиск», который строит собственный индекс по всем инфоблокам, где включена индексация.
Выдачу с общим индексом подключает компонент bitrix:search.page. Инфоблоки в нём выбираются через arrFILTER по типам и параметры arrFILTER_iblock_ТИП с перечнем ID:
<?php
$APPLICATION->IncludeComponent(
'bitrix:search.page',
'.default',
array(
'RESTART' => 'Y',
'NO_WORD_LOGIC' => 'N',
'USE_LANGUAGE_GUESS' => 'Y',
'CHECK_DATES' => 'Y',
'USE_TITLE_RANK' => 'Y',
'DEFAULT_SORT' => 'rank',
'PAGE_RESULT_COUNT' => '20',
'arrFILTER' => array('iblock_catalog', 'iblock_content'),
'arrFILTER_iblock_catalog' => array('2'),
'arrFILTER_iblock_content' => array('5', '7'),
)
);
В имени параметра стоит символьный код типа инфоблока: catalog и content в примере это типы, а в массивах лежат ID самих инфоблоков. Подставьте свои значения из настроек. Типы могут быть разными, компонент собирает их в одну выдачу.
Если нужен полностью свой вывод, тот же индекс доступен из PHP через класс CSearch, но в большинстве проектов мне хватало компонента и кастомного шаблона в /local/templates/название_шаблона/components/bitrix/search.page/. Править файлы в /bitrix/components/ нельзя: при обновлении правки пропадут, а папка /local имеет приоритет над /bitrix.
Одна ловушка, на которую я налетал не раз: поиск не находит то, чего нет в индексе. Добавили инфоблок, включили индексацию, а старые элементы в выдачу не попали: индекс надо пересобрать переиндексацией в модуле поиска. Новые и изменённые элементы затем попадают в индекс сами, но только для инфоблоков с включённой индексацией.
Какой способ выбрать под задачу
Сводка по четырём вариантам, включая цикл, от которого мы уходим:
| Способ | Число запросов | Морфология и релевантность | Ссылки и права |
|---|---|---|---|
| Цикл по инфоблокам | по одному на инфоблок | нет, только подстрока | есть, если не забыть фильтры в каждой ветке |
GetList с массивом IBLOCK_ID |
один (плюс один на счётчики) | нет, подстрока и сортировка полей | есть: DETAIL_PAGE_URL, CHECK_PERMISSIONS |
ElementTable в D7 |
один | нет, подстрока | нет, всё пишется вручную |
Модуль search и search.page |
один к индексу | есть, выдача по релевантности | есть, включая даты активности |
Моё правило простое. Строка поиска для посетителя: модуль search, потому что только он ранжирует и понимает словоформы. Быстрая подсказка по названию, автодополнение, выбор элемента в форме: GetList с массивом IBLOCK_ID. Служебные выгрузки и проверки: D7. Цикл по инфоблокам не оставляю нигде, кроме случая, когда у инфоблоков разные наборы свойств и общий запрос строить бессмысленно.
Что проверить перед запуском на боевом сайте
После переезда с цикла на общий запрос я прохожу одни и те же пункты.
- Проверяю, что закрытые инфоблоки не попали в массив ID. Права смотрю под гостем, а не под администратором: администратор увидит всё, и ошибка останется незамеченной.
- Ищу элемент с истёкшей датой активности. Он не должен появляться в выдаче ни в
GetList(ключACTIVE_DATE), ни в поиске (параметрCHECK_DATES). - Открываю по одной ссылке из каждого инфоблока и смотрю, что адрес ведёт на нужную детальную страницу, а не на 404. Шаблоны адресов у инфоблоков разные, и чаще всего ломается тот, который подключали последним.
- Сверяю счётчики со списком. Если во вкладке написано «Статьи (5)», а в списке их четыре, значит, в выборке и в счётчике разные условия фильтра. Условия лучше собрать в одну переменную и передавать в оба вызова.
- Для поиска через модуль запускаю переиндексацию и проверяю запрос со словоформой, например «кабеля» вместо «кабель».
По кэшу: выдачу по произвольной строке кэшировать почти бессмысленно, каждый посетитель вводит своё. Кэш окупается на счётчиках и на списках популярных запросов, а также на справочных данных вроде названий инфоблоков для вкладок. Если нужно встроить общий поиск в шаблон действующего проекта на Битриксе и разобраться с индексом, такие задачи я беру как доработка и поддержка 1С-Битрикс от 3 000 ₽/час, срок от 1 часа на задачу.
Механика инфоблоков и модуля поиска в Битриксе меняется от версии к версии, поэтому перед внедрением я сверяюсь с актуальной документацией модулей «Информационные блоки» и «Поиск».
Частые вопросы
Можно ли искать одновременно по инфоблокам разных типов?
В CIBlockElement::GetList тип инфоблока не мешает: в IBLOCK_ID можно перечислить ID инфоблоков из любых типов, метод вернёт их одним списком. В компоненте bitrix:search.page типы перечисляются в arrFILTER, а ID инфоблоков внутри каждого типа задаются отдельным параметром arrFILTER_iblock_ТИП.
Как отсортировать результаты по релевантности, если использую GetList?
У GetList релевантности нет: он сортирует по полям элемента, например по SORT, NAME или дате. Если нужно ранжирование, берите модуль search (у компонента search.page есть сортировка по рангу). Как компромисс можно сначала искать точные совпадения названия, а потом подстроки, но два запроса вместо одного уже не то, ради чего всё затевалось.
Почему поиск не находит новые или старые элементы?
Обычно причин три. Для инфоблока не включена индексация для поиска. После добавления инфоблока не сделана переиндексация, и старые элементы в индексе отсутствуют. Или у элемента истёк срок активности: при включённой проверке дат он из выдачи исчезает. Проверяйте в таком порядке, это самые частые случаи.
Где хранить код кастомного вывода поиска?
Шаблон компонента копируйте в /local/templates/название_шаблона/components/bitrix/search.page/, общую функцию выборки кладите в файлы под /local, например в /local/php_interface/. Папка /bitrix/ для правок не подходит: при обновлении ядра изменения потеряются, а /local имеет приоритет при подключении шаблонов.