Bitrix Framework

Фреймворк для работы с Битрикс24
и 1С‑Битрикс: Управление сайтом

Продукты

Bitrix Framework — это основа для 1C‑Битрикс: Управление сайтом и Битрикс24. Фреймворк включает готовый набор PHP‑инструментов, которые помогают разрабатывать и расширять эти продукты. Проекты можно развернуть на готовой виртуальной машине BitrixVM.

Управление сайтом

CMS для интернет-магазинов и сайтов. Поддерживает заказы в многопоточном режиме, API для интеграций и встроенное кеширование.

Инструкция по установке

Битрикс24

Платформа для автоматизации бизнеса и командной работы. Объединяет CRM, управление задачами, документы и видеозвонки в едином интерфейсе.

Инструкция по установке

BitrixVM

Готовая виртуальная машина помогает быстро развернуть проекты на Bitrix Framework. Содержит сервер с настроенной и проверенной конфигурацией.

Инструкция по установке

Преимущества фреймворка

CMS из коробки

Включает CMS с полным набором функций:

управление структурой и содержимым
SEO-инструменты
система прав доступа
готовая база для e-commerce и корпоративных решений

О продукте на сайте компании

Модульность

Позволяет расширять функционал без изменения ядра с помощью:

API для разработки кастомных решений
каталога готовых решений в Маркетплейсе

Маркетплейс

Маркет Битрикс24

Интеграции

Поддерживает:

REST API для двустороннего обмена данными
вебхуки для событийной модели
стандартные коннекторы для 1С, email-сервисов и CRM

Документация REST API

Стандарты разработки

Придерживается основных стандартов PHP:

стиль кода PSR-1
автозагрузка классов PSR-4
интерфейсы HTTP PSR-7
менеджер пакетов Composer

Безопасность

Имеет встроенную защиту от основных угроз:

фильтрация данных от XSS и SQL-инъекций
защита от CSRF-атак
регулярные обновления безопасности

Масштабируемость

Обеспечивает высокую производительность под нагрузкой за счет:

многоуровневого кеширования
встроенных механизмов кластеризации
интеграции с облачными хранилищами

Инструменты разработки

Фреймворк включает готовые компоненты для разработки.

Работайте с автоматической валидацией и DI-инъекцией.

namespace Demo\Module\Controller;
        
        use Bitrix\Main\Engine\Controller;
        use Bitrix\Main\Validation\Rule\NotEmpty;
        
        class Post extends Controller
        {
            public function getAction(
                #[NotEmpty]
                string $code,
                PostService $service,
            ) {
                $entity = $service->getByCode($code);
                if (!$entity) {
                    return $this->renderComponent('demo:error', params: [
                        'message' => Loc::getMessage('POST_NOT_FOUND'),
                    ]);
                }
        
                return $this->renderView('posts/view', [
                    'entity' => $entity,
                ]);
            }
        }

Инструменты безопасности

Гибко настраивайте права доступа к данным и функциям. Это защитит от утечек и поможет выполнить требования закона.

Регистрируйте сотрудников с подтверждением email или через корпоративный портал
Настраивайте двухфакторную аутентификацию для доступа к критичным разделам
Просматривайте историю входов и подозрительную активность
Выполняйте автоматические и ручные блокировки пользователей

Используйте API для работы с пользователями

/**
        * @var CUser $USER
        */
        
        // Проверить права на выполнение действий
        if ($USER->CanDoOperation('edit_file')) {
            // доступ есть
        }
        
        // Зарегистрировать пользователя
        $USER->SimpleRegister('user@example.com');
        
        // Заблокировать пользователя
        $USER->Update(234, [
            'BLOCKED' => 'Y',
        ]);
        
        // Потребовать сменить пароль при следующей авторизации
        $USER->Update(234, [
            'PASSWORD_EXPIRED' => 'Y',
        ]);

Создавайте отдельные группы для отделов: бухгалтерия, маркетинг, IT и так далее
Ограничивайте доступ к финансовым данным и персональной информации
Настраивайте политики паролей для разных групп

Используйте API для работы с группами

// Получить список групп пользователя
        $groups = CUser::GetUserGroup(234);
        
        // Добавить пользователя в группы
        CUser::AppendUserGroup(234, [
            // идентификатор группы
            3,
            // срок участия пользователя в группе
            [
                'GROUP_ID' => 3,
                'DATE_ACTIVE_FROM' => '01.01.2025',
                'DATE_ACTIVE_TO' => '01.12.2025',
            ],
        ]);
        
        // Удалить пользователя из группы
        CUser::RemoveUserGroup(234, [
            // идентификаторы групп
            3,
            4,
        ]);

Настраивайте гибкую систему прав ABAC на основе атрибутов и объектов
Контролируйте доступ к модулям через атрибуты: отдел, должность, расположение
Проводите аудит всех изменений прав доступа

Используйте API для работы с ролями

Создать контроллер прав доступа:

use Bitrix\Main\Access\AccessibleItem;
        use Bitrix\Main\Access\BaseAccessController;
        use Bitrix\Main\Access\User\AccessibleUser;
        
        final class PostAccessController extends BaseAccessController
        {
            protected function loadItem(int $itemId = null): ?AccessibleItem
            {
                return $itemId ? MyPost::loadById($itemId) : null;
            }
        
            protected function loadUser(int $userId): AccessibleUser
            {
                return MyUser::loadById($userId);
            }
        }

Внедрить контроль прав в методы контроллера:

use Bitrix\Main\Engine\CurrentUser;
        
        final class MyController
        {
            public function getAction(int $id, CurrentUser $user, PostAccessController $access)
            {
                if ($access->can($user->getId(), 'view', $id)) {
                    // есть доступ
                }
            }
        
            public function listAction(PostAccessController $access)
            {
                $query = MyPost::query();
        
                $filter = $access->getEntityFilter(
                    'view',
                    $query->getEntity()->getObjectClassName()
                );
                if ($filter) {
                    $query->addFilter($filter);
                }
        
                $rows = $query->fetchCollection();
            }
        }

Быстрый старт с Docker-образом

Склонируйте официальный репозиторий

cd my-project
        git clone https://github.com/bitrix-tools/env-docker.git

Настройте обязательные параметры. Укажите:
- пароли баз данных MySQL и Postgres в файле .env_sql
- секретный ключ для Push-сервера в файле .env_push
Запустите контейнеры
```
docker compose up -d
        
```

Скачайте скрипт bitrixsetup.php в папку www

docker compose exec —user=bitrix php sh
        cd /opt/www/
        wget https://www.1c-bitrix.ru/download/scripts/bitrixsetup.php

Откройте в браузере адрес http://localhost:8588/bitrixsetup.php
Следуйте инструкциям мастера

Контейнерное окружение для продуктов Битрикс

Инструкция по установке продуктов