component_epilog.php Выполнение кода после вывода шаблона компонента

В жизненном цикле компонента Битрикс есть специальный файл — component_epilog.php.

Он выполняется после того, как отработал template.php, то есть после того, как основной HTML компонента уже был сгенерирован и выведен в буфер.

Расположение: /path/to/component/templates/template_name/component_epilog.php

Зачем он нужен? Классические задачи

Основная ценность component_epilog.php в том, что на момент его выполнения уже точно известны все данные, которые были отображены пользователю.

Это идеальное место для задач, которые зависят от финального результата.

1. Установка SEO-заголовков и мета-тегов (SetPageProperty)

Это самая частая и правильная задача для эпилога.

Например, в детальной карточке товара (catalog.element) нужно установить title и description страницы на основе названия и описания товара.

Если сделать это в component.php, а в шаблоне по какой-то причине товар не будет выведен (например, сработает условие if), то мета-теги все равно установятся, что некорректно. В component_epilog.php мы уверены, что товар был показан.

// /components/bitrix/catalog.element/templates/.default/component_epilog.php
if (!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true) die();

/** @var array $arResult */
global $APPLICATION;

// Если у нас есть данные об элементе и они были выведены
if (isset($arResult['ID']) && $arResult['ID'] > 0) {
    
    // Устанавливаем заголовок страницы (<title>)
    $APPLICATION->SetPageProperty('title', $arResult['META_TITLE'] ?: $arResult['NAME']);
    
    // Устанавливаем мета-тег description
    $APPLICATION->SetPageProperty('description', $arResult['META_DESCRIPTION'] ?: '');
}

• Доступные переменные: В component_epilog.php доступны все те же переменные, что и в template.php: $arResult, $arParams, $component.

2. Добавление элементов в навигационную цепочку («хлебные крошки»)

Аналогично заголовкам, добавлять текущий элемент в «хлебные крошки» нужно только после того, как мы убедились, что он был показан.

// /components/bitrix/news.detail/templates/.default/component_epilog.php
if (!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true) die();

/** @var array $arResult */
global $APPLICATION;

if ($arParams["ADD_ELEMENT_CHAIN"] == "Y" && !empty($arResult['NAME'])) {
    $APPLICATION->AddChainItem($arResult["NAME"]);
}

3. Подключение JS-расширений или выполнение JS-кода

Иногда JS-код или расширение требуются только если компонент успешно отработал и вывел определенные данные.

// component_epilog.php
if ($arResult['SHOW_GALLERY']) {
    \CJSCore::Init(['popup', 'fx']);
    // Можно даже сгенерировать JS-код на основе $arResult
    ?>
    <script>
        BX.ready(function(){
            // Инициализация галереи для элемента с ID <?=$arResult['ID']?>
        });
    </script>
    <?
}

Важно: Код из component_epilog.php выводится после основного HTML компонента. Если вы подключаете здесь JS, убедитесь, что это не приведет к ошибкам (например, скрипт не пытается найти DOM-элементы, которые были выше по коду).

Что НЕ нужно делать в component_epilog.php

• Выполнять «тяжелые» запросы к БД. Вся выборка данных должна быть в component.php. Эпилог — не для этого.
• Генерировать HTML-верстку. Весь HTML должен быть в template.php.
• Изменять $arResult. Это бессмысленно, так как template.php уже отработал.

Вывод:
component_epilog.php — это «последнее слово» компонента.

Он идеально подходит для «пост-обработки» страницы: установки заголовков, хлебных крошек и выполнения других действий, которые должны произойти гарантированно после того, как основной контент компонента был успешно сгенерирован.

Правильное использование эпилога делает ваши компоненты более логичными и предсказуемыми.

component_epilog.php, Битрикс, эпилог компонента, SetPageProperty, AddChainItem, SEO, хлебные крошки, жизненный цикл компонента.