PHPTime

Сертификация Битрикс: ответы на тест курса «Компоненты 2.0»

Курс «Компоненты 2.0» — один из ключевых этапов в подготовке к сертификации разработчика 1С-Битрикс. Экзаменационные вопросы затрагивают архитектуру компонентов, работу с ЧПУ, шаблонами и кешированием. В этом разборе собраны проверенные ответы, которые помогут пройти тест с максимальным баллом.

Подключение шаблона и структура компонента

Ключевое отличие компонентов второй версии — жёсткое разделение логики и представления. Логика находится в файлах component.php и class.php, а представление вынесено в папку templates. При этом для одной и той же логики можно создать сколько угодно шаблонов: системный, пользовательский в шаблоне сайта, кастомный для конкретной задачи.

Шаблон подключается явно только в одном месте — внутри метода executeComponent() или после того, как логика отработала:

PHP
declare(strict_types=1);

final class NewsListComponent extends CBitrixComponent
{
    public function executeComponent(): void
    {
        // … получаем данные, наполняем $this->arResult …
        $this->includeComponentTemplate();
    }
}

Никаких Include(...) вызывать не нужно: метод includeComponentTemplate() сам определит подходящий шаблон исходя из контекста вызова и параметра templatePage.

Дерево компонентов визуального редактора

Панель компонентов в визуальном редакторе строится динамически на основе содержимого пространств имён. Состав этой панели нельзя запрограммировать отдельно — он полностью определяется тем, какие директории физически присутствуют в /bitrix/components/ и какие языковые файлы описания заполнены.

Если скопировать системный компонент в пользовательское пространство имён, он сразу появится в дереве со своим названием и описанием. Отдельных закладок «только 2.0» или «только 1.0» нет — редактор показывает все установленные компоненты.

UrlRewrite и ЧПУ в комплексных компонентах

Механизм urlrewrite.php отвечает за преобразование человекочитаемых адресов во внутренние переменные. Классическая задача: запрос вида /forum/general/5.php должен обработаться как /forum/index.php?ID=5&CODE=general.

Правильный массив правила выглядит так:

PHP
[
    "CONDITION" => "#^/forum/([a-zA-Z0-9]+)/([0-9]+)\\.php#",
    "RULE"      => "ID=$2&CODE=$1",
    "PATH"      => "/forum/index.php",
]

Здесь CONDITION — регулярное выражение, которое проверяет входящий URI. RULE описывает, как преобразовать найденные группы в параметры запроса. PATH — физический файл, который обработает запрос. Важно помнить, что порядок групп в регулярном выражении влияет на номера $1 и $2, и путать их нельзя.

Когда визуальный редактор сохраняет страницу с комплексным компонентом, в котором заполнены параметры SEF, новые правила регистрируются в urlrewrite.php автоматически. Ошибки при сохранении не возникает — система корректно обрабатывает массив SEF_URL_TEMPLATES.

Комплексный компонент и метод ParseComponentPath

Комплексный компонент отличается от обычного тем, что он не выводит данные напрямую, а определяет, какую страницу показать пользователю. Для этого используется CComponentEngine::ParseComponentPath(). Метод принимает путь до каталога с ЧПУ, шаблоны путей и реальный адрес, а возвращает три значения:

  • массив $arVariables — значения переменных, извлечённые из адреса по шаблону пути;
  • массив $arDefaultVariableAliases404 — псевдонимы переменных по умолчанию для режима ЧПУ;
  • массив $arComponentVariables — список имён переменных, которые компонент умеет принимать.

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

Метод CComponentEngine::InitComponentVariables() решает смежную задачу: он восстанавливает значения переменных из псевдонимов, объединяя стандартные алиасы с теми, что пришли в $arParams. Это нужно, чтобы внутри компонента можно было обращаться к переменным по каноническим именам.

Файлы .parameters.php, .description.php и result_modifier.php

Любой компонент, который должен управляться через публичный или административный интерфейс, обязан содержать файл .parameters.php. Он подключается только в момент редактирования параметров компонента — при настройке в режиме правки или в административном разделе. На рядовой отрисовке страницы этот файл не нужен и не вызывается.

Файл .description.php у самого компонента обязателен: он задаёт название, описание и путь в дереве редактора. А вот у шаблона такого файла может не быть — тогда шаблон просто не получит собственного описания, но останется рабочим. Это стандартная практика: системные шаблоны часто идут с .description.php, а пользовательские обходятся без него.

result_modifier.php в шаблоне компонента нужен для финальной подгонки данных под конкретное представление. Его задача — изменить массив $arResult так, как нужно именно этому шаблону: пересобрать структуру, добавить ключи, отфильтровать лишнее. Логику самого компонента он не трогает и работает только на уровне представления.

Языковые файлы, заголовки и управление компонентом

Языковые файлы подключаются автоматически, если они названы правильно и лежат в папке lang. Метод IncludeLangFile() — это утилита для поднятия языковых сообщений в нужный контекст, но на уровне ядра подстановка сообщений работает сама.

Если на странице несколько компонентов пытаются установить заголовок через SetTitle(), победит последний по порядку выполнения. Это частая ошибка при вёрстке посадочных страниц: заголовок меняет тот компонент, который отработал позже всех. Учитывайте это, когда выводите на одной странице и каталог, и детальный просмотр новости.

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

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

Установка сторонних компонентов и пространства имён

Системные компоненты лежат строго в /bitrix/components/bitrix/. Это защищённое пространство, его нельзя перезаписывать вручную — при обновлении ядра всё будет затёрто. Сторонние компоненты ставятся копированием в /bitrix/components/ или любую её подкаталог, кроме bitrix.

Например:

PHP
/local/components/mystudio/news.list/
/local/components/mystudio/catalog.section/
/local/components/custom/feedback.form/

Первое имя после components — это пространство имён. В визуальном редакторе каждый namespace отображается как отдельный корневой узел дерева. Современные стандарты Битрикс рекомендуют использовать директорию /local/components/ вместо прямого копирования в /bitrix/components/: так проще переносить проект и чище разделять ядро и кастом.

События ядра и автокеширование

Влиять на ход выполнения API-функций ядра можно через систему событий. Обработчики регистрируются и перехватывают вызовы до и после ключевых операций: добавление элемента инфоблока, обработка заказа, отправка письма. Паттерны проектирования — это архитектурный инструмент, а не механизм изменения поведения ядра; отложенные функции добавляют HTML в буфер, но не влияют на API.

Отдельная тема — кеширование. Если нужно сохранить и HTML-вывод, и PHP-переменные, используется класс CPHPCache. Он пишет в файл кеша как контент, так и сериализованные данные. Применение этого класса оправдано, когда после генерации HTML нужно ещё раз обратиться к результатам выборки.

Для автокеширования в компоненте обязательно задать if($this->StartResultCache()) перед основной работой и $this->EndResultCache() после подключения шаблона. Без этих вызовов автоматический кеш не подключится, сколько бы ни был заполнен $arParams["CACHE_TIME"].

Итоговый чек-лист перед экзаменом

  • Повторите, где хранятся системные и пользовательские компоненты: /bitrix/components/bitrix/ и /local/components/.
  • Запомните сигнатуру ParseComponentPath() и что возвращает InitComponentVariables().
  • Разберите структуру массива в urlrewrite.php и порядок групп в регулярном выражении.
  • Убедитесь, что понимаете разницу между .parameters.php, .description.php и result_modifier.php.
  • Проверьте, как работает приоритет заголовков при нескольких компонентах на странице.
  • Вспомните, что языковые файлы подхватываются автоматически, а шаблон подключается только через includeComponentTemplate().

Частые вопросы

Где хранятся системные компоненты 1С-Битрикс?

Системные компоненты находятся в директории /bitrix/components/bitrix/. Пользовательские и сторонние компоненты размещаются в /local/components/ или /bitrix/components/, но не в подпапке bitrix.

Чем компоненты 2.0 отличаются от компонентов первой версии?

Главное отличие — разделение логики и представления. Логика пишется в component.php и class.php, а представление выносится в папку templates. Для одной логики можно создать несколько шаблонов.

Как подключить шаблон компонента в коде?

Шаблон подключается методом $this->includeComponentTemplate() внутри executeComponent(). Никаких ручных Include() не требуется.

Зачем нужен файл result_modifier.php?

Он изменяет структуру массива $arResult перед выводом в конкретном шаблоне: добавляет дополнительные поля, перегруппировывает данные или фильтрует их под требования вёрстки.

Справка по теме

Ещё в разделе «1С-Битрикс»

Сертификация Битрикс: ответы по модулю «Управление структурой»

Разбираем ответы сертификационного теста 1С-Битрикс «Управление структурой» для контент-менеджеров: медиабиблиотека, менеджер файлов, меню и права доступа.

4 мин

Сертификация Bitrix: тест «Информация на сайте и работа с ней» для контент-менеджера

Разбор темы «Информация на сайте и работа с ней» для сертификации 1С-Битрикс: статика и динамика, включаемые области, права доступа, шаблоны.

5 мин

Элементы управления административного интерфейса 1С-Битрикс: полный разбор

Как работают фильтры, контекстные панели и меню в административном разделе 1С-Битрикс. Разбор вопросов сертификации и грамотное применение в PHP 8.3+.

6 мин

Компоненты 2.0 в Битрикс: устройство, управление и ответы на тест для контент-менеджера

Как работают компоненты 2.0 в «1С-Битрикс»: простые и комплексные, редактирование кода, заголовки страниц, права доступа. Разбор темы для сертификации контент-менеджера.

6 мин