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

На них держится почти весь код Битрикса. То, что на странице выводится из базы, почти всегда выводит именно компонент: каталог, фильтр, корзина, форма обратной связи, меню, хлебные крошки. Разработчик или контент-менеджер размещает его на странице и задаёт параметры — какой инфоблок брать, сколько записей показывать, сколько времени хранить кэш, — а остальное компонент делает сам.

Ключевая идея — разделение логики и внешнего вида. Код выборки живёт в самом компоненте, а HTML — в шаблоне компонента. Чтобы изменить вёрстку списка новостей, не нужно трогать выборку, достаточно поправить шаблон.

Из чего состоит

/local/components/my/price.list/
    class.php              — логика компонента
    .description.php       — название и место в списке компонентов
    .parameters.php        — параметры для настройки
    lang/ru/               — языковые фразы
    templates/.default/
        template.php       — вывод по умолчанию

Стандартные компоненты лежат в /bitrix/components/bitrix/, свои — в папке /local/components/ со своим пространством имён. На странице компонент вызывается методом $APPLICATION->IncludeComponent() с именем, шаблоном и массивом параметров.

Пример логики с кэшированием

class MyPriceListComponent extends CBitrixComponent
{
    public function executeComponent()
    {
        if ($this->startResultCache()) {
            $this->arResult['ITEMS'] = $this->loadItems();
            $this->includeComponentTemplate();
        }
    }
}

Если кэш свежий, выборка и шаблон не выполняются: Битрикс отдаёт сохранённый результат. Метод loadItems() здесь — собственный метод компонента с запросом к базе.

Главное правило доработок

Файлы в /bitrix/components/bitrix/ перезаписываются обновлениями. Любая правка там исчезнет после ближайшего обновления платформы. Нужен другой вид — копируют шаблон в шаблон сайта. Нужна другая логика — создают свой компонент или пишут обработчик события. Как обновлять платформу, не теряя изменений, разобрано в статье об обновлении 1С-Битрикс без потери доработок. Компоненты, которые сами обслуживают целый раздел с разными страницами, называются комплексными.

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

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

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