Что такое «Комплексный компонент Битрикс»
Новостной раздел на любом сайте устроен одинаково: список новостей, страница рубрики, страница одной новости, иногда поиск и архив по датам. Можно сделать под каждый вид отдельный файл и разместить в нём свой компонент. Комплексный компонент делает это за одну точку входа: в разделе лежит один 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

