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

