Что такое «Комплексный компонент Битрикс»

Новостной раздел на любом сайте устроен одинаково: список новостей, страница рубрики, страница одной новости, иногда поиск и архив по датам. Можно сделать под каждый вид отдельный файл и разместить в нём свой компонент. Комплексный компонент делает это за одну точку входа: в разделе лежит один index.php, а компонент по адресу понимает, какую страницу показать.

Классические примеры из стандартной поставки — bitrix:news, bitrix:catalog, bitrix:forum. Внутри них нет собственной логики вывода списка или карточки: шаблон комплексного компонента состоит из файлов-страниц, и в каждом вызывается обычный простой компонент — news.list, news.detail и так далее.

Как работает разбор адресов

В режиме ЧПУ компонент получает папку раздела и шаблоны адресов для каждой страницы. Веб-сервер передаёт все несуществующие адреса внутри папки в обработчик Битрикса, тот по правилам из urlrewrite.php направляет запрос в index.php раздела, и компонент сопоставляет адрес с шаблонами.

Пример вызова

<?php $APPLICATION->IncludeComponent('bitrix:news', '', [
    'IBLOCK_TYPE'       => 'news',
    'IBLOCK_ID'         => 3,
    'SEF_MODE'          => 'Y',
    'SEF_FOLDER'        => '/news/',
    'SEF_URL_TEMPLATES' => [
        'news'    => '',
        'section' => '#SECTION_CODE#/',
        'detail'  => '#SECTION_CODE#/#ELEMENT_CODE#/',
    ],
]); ?>

Здесь адрес /news/ покажет общий список, /news/akcii/ — рубрику, а /news/akcii/skidka-20/ — отдельную новость.

Типичные ошибки

  • Параметры компонента поправили в коде, а правило в urlrewrite.php осталось старым — вложенные страницы отдают 404.
  • Скопировали шаблон комплексного компонента целиком ради одной правки в карточке, и после обновлений он перестал соответствовать новым параметрам.
  • Включили ЧПУ, но у элементов не заполнен символьный код, и адреса получаются пустыми.

Перестройку разделов с комплексными компонентами и разбор старых доработок обычно делают в рамках доработки сайта на 1С-Битрикс.

Связанные термины

Обновлено: 10 октября 2026

Все термины раздела «1С-Битрикс» ↗