Кастомные страницы в 1С-Битрикс: D7-контроллеры и маршрутизация

Когда стандартных страниц недостаточно: реальная проблема

На одном проекте потребовалось создать интерфейс для управления партнёрскими программами с гибкими правилами. Стандартные компоненты Битрикс не подходили — требовалась сложная бизнес-логика с кастомными правами доступа и интеграцией с внешними API. Ручное создание admin-файлов привело бы к дублированию кода и проблемам с обновлениями. Мы выбрали подход на D7 — контроллеры с маршрутизацией, встроенной защитой от CSRF и модульной архитектурой. Разработка заняла 5 дней вместо ожидаемых 2 недель. Экономия бюджета составила существенную сумму за счёт сокращения времени доработок. Наши инженеры имеют сертификаты «1С-Битрикс» и опыт работы с D7 с момента выхода платформы. Свяжитесь с нами, чтобы получить аналогичный результат.

Почему стоит выбрать MVC Controller в Битрикс?

Контроллер избавляет от шаблонного кода: проверка прав через prefilters, автоматический CSRF, поддержка JSON и сессий. В классическом admin-файле вы сами вызываете bitrix_sessid_post() и проверяете права. Опыт нашей команды (более 50 проектов на Битрикс) показывает, что переход на контроллеры сокращает время разработки на 1–2 дня на страницу. Гарантируем стабильность при обновлениях ядра — все prefilters и маршруты управляются кодом, а не файлами. Кроме того, снижаются затраты на сопровождение на 20–30% за счёт единообразной структуры.

Как создать кастомную страницу на D7? Два подхода

Классический admin-файл (/bitrix/admin/my_page.php) — простейший вариант, пригодный для вспомогательных инструментов. Он не требует настройки маршрутизации, но вся проверка прав и CSRF ложится на разработчика.

<?php
require_once($_SERVER["DOCUMENT_ROOT"] . "/bitrix/modules/main/include/prolog_admin_before.php");

use Bitrix\Main\Loader;
use Bitrix\Main\Localization\Loc;

Loader::includeModule('my.module');

// Проверка прав
if (!$APPLICATION->IsAdminPage() || !\CMain::GetUserRight("main") >= "S") {
    $APPLICATION->AuthForm("Доступ запрещён");
}

$APPLICATION->SetTitle("Мой инструмент");

require($_SERVER["DOCUMENT_ROOT"] . "/bitrix/modules/main/include/prolog_admin_after.php");

// Вывод содержимого страницы
?>
<form method="post" action="<?= $APPLICATION->GetCurPage() ?>">
    <?= bitrix_sessid_post() ?>
    <!-- поля формы -->
    <input type="submit" value="Выполнить">
</form>
<?php
require($_SERVER["DOCUMENT_ROOT"] . "/bitrix/modules/main/include/epilog_admin.php");

MVC через Controller — правильный путь для страниц с логикой.

namespace MyProject\Controllers;

use Bitrix\Main\Engine\Controller;
use Bitrix\Main\Engine\ActionFilter;

class ReportController extends Controller
{
    public function configureActions(): array
    {
        return [
            'getReport' => [
                'prefilters' => [
                    new ActionFilter\Authentication(),
                    new ActionFilter\HttpMethod(['GET', 'POST']),
                    new ActionFilter\Csrf(),
                ],
            ],
        ];
    }

    public function getReportAction(int $periodDays = 30): array
    {
        $data = \MyProject\Services\ReportService::build($periodDays);
        return ['data' => $data, 'total' => count($data)];
    }
}

Контроллер автоматически обрабатывает запросы, проверяет CSRF-токен и возвращает JSON. Маршрут регистрируется через \Bitrix\Main\Routing\Router::getInstance()->add().

Пошаговая инструкция: создание контроллера для кастомной страницы

1. Определите namespace и класс контроллера, унаследовав его от \Bitrix\Main\Engine\Controller.
2. Реализуйте метод configureActions(), задав prefilters для проверки прав и CSRF.
3. Создайте action-методы (например, getListAction, saveAction) с валидацией параметров.
4. Зарегистрируйте маршрут в файле local/routes.php или через Router::add().
5. Настройте права доступа с помощью ActionFilter\Permission или кастомных фильтров.
6. Интегрируйте UI: для списков используйте CAdminList, для форм — CAdminForm.

Что даёт использование MVC Controller в Битрикс?

Контроллер избавляет от шаблонного кода: проверка прав через prefilters, автоматический CSRF, поддержка JSON и сессий. В классическом admin-файле вы сами вызываете bitrix_sessid_post() и проверяете права. Опыт нашей команды (более 50 проектов на Битрикс) показывает, что переход на контроллеры сокращает время разработки на 1–2 дня на страницу. Гарантируем стабильность при обновлениях ядра — все prefilters и маршруты управляются кодом, а не файлами.

Постраничная навигация и UI: интеграция с D7

Для списков данных используйте \Bitrix\Main\UI\PageNavigation:

use Bitrix\Main\UI\PageNavigation;

$nav = new PageNavigation('page');
$nav->allowAllRecords(false)
    ->setPageSize(20)
    ->initFromUri();

$result = \MyProject\Storage\OrderLogTable::getList([
    'select'     => ['*'],
    'order'      => ['ID' => 'DESC'],
    'count_total' => true,
    'offset'     => $nav->getOffset(),
    'limit'      => $nav->getLimit(),
]);

$nav->setRecordCount($result->getCount());

Для административных страниц со списками — готовый UI через CAdminList и CAdminFilter.

Сравнение подходов: admin-файл vs Controller

Сроки и стоимость

Стоимость рассчитывается индивидуально. В среднем экономия времени на поддержке составляет 20–30% по сравнению с классическим подходом. Подробнее о преимуществах D7 читайте в официальной документации 1С-Битрикс и на Wikipedia.

Что входит в работу

• Проектирование архитектуры страницы (контроллеры, маршруты, шаблоны)
• Реализация бизнес-логики на D7 с учётом кэширования и прав доступа
• Интеграция с UI Битрикс (CAdminList, фильтры, постраничная навигация)
• Документация по API и структуре кода
• Передача доступов (репозиторий, БД, админка)
• Обучение команды поддержке страницы
• Гарантия 3 месяца на функциональность

Кастомная страница на D7 — это не замена компонентной системе. Это инструмент для задач, которые не укладываются в стандартную модель: инструменты администратора, интерфейсы импорта, дашборды с агрегированными данными. Написанные правильно, они не конфликтуют с ядром при обновлениях. Получите консультацию по вашему проекту — оценим сложность и сроки за 1 день. Запишитесь на бесплатную демонстрацию.