# Bitrix Framework — Документация

> Официальная документация по Bitrix Framework на русском языке. Содержит руководства и справочники для разработчиков, работающих с 1С-Битрикс: Управление сайтом и Битрикс24. Охватывает архитектуру фреймворка, ORM, базу данных, основы CMS, безопасность, производительность и модули. Ориентирована на PHP-разработчиков, создающих сайты, компоненты, модули и интеграции на базе Bitrix Framework.
> Полный список статей: https://docs.1c-bitrix.ru/pages-index.json

## С чего начать

- [Установка окружения](https://docs.1c-bitrix.ru/pages/get-started/install-env.html): Настройка локального окружения для разработки, Docker-образы BitrixVM
- [Установка дистрибутива](https://docs.1c-bitrix.ru/pages/get-started/install-distr.html): Пошаговая установка 1С-Битрикс: Управление сайтом
- [Установка решения](https://docs.1c-bitrix.ru/pages/get-started/install-solution.html): Развёртывание готового решения на базе фреймворка
- [Структура директорий](https://docs.1c-bitrix.ru/pages/get-started/directory-structure.html): Обзор файловой структуры проекта
- [Composer](https://docs.1c-bitrix.ru/pages/get-started/composer.html): Управление зависимостями через Composer в Bitrix-проектах
- [Создание страницы](https://docs.1c-bitrix.ru/pages/get-started/create-page.html): Создание первой страницы в системе
- [Создание компонента](https://docs.1c-bitrix.ru/pages/get-started/create-component.html): Разработка пользовательского компонента
- [Создание модуля](https://docs.1c-bitrix.ru/pages/get-started/create-module.html): Разработка собственного модуля
- [Создание контроллера](https://docs.1c-bitrix.ru/pages/get-started/create-controller.html): Создание контроллера для обработки запросов
- [Что дальше](https://docs.1c-bitrix.ru/pages/get-started/next-steps.html): Рекомендации по дальнейшему изучению фреймворка

## О фреймворке

- [Экосистема](https://docs.1c-bitrix.ru/pages/about/ecosystem.html): Обзор Bitrix Framework как основы для 1С-Битрикс: Управление сайтом и Битрикс24
- [Отличия от других CMS](https://docs.1c-bitrix.ru/pages/about/cms-comparison.html): Сравнение с WordPress, Joomla и другими CMS
- [Отличия от других фреймворков](https://docs.1c-bitrix.ru/pages/about/framework-comparison.html): Сравнение с Laravel, Symfony, Yii — контроллеры, роутинг, ORM

## Основы фреймворка

- [Конфигурация ядра](https://docs.1c-bitrix.ru/pages/framework/settings.html): Параметры конфигурации ядра Bitrix Framework
- [Архитектура](https://docs.1c-bitrix.ru/pages/framework/architecture.html): Модульная архитектура фреймворка, принципы организации кода
- [Автозагрузка классов](https://docs.1c-bitrix.ru/pages/framework/autoloading.html): Механизм автозагрузки классов, PSR-4 и стандарты Bitrix
- [Жизненный цикл запроса](https://docs.1c-bitrix.ru/pages/framework/request-lifecycle.html): Этапы обработки HTTP-запроса от входа до ответа
- [Роутинг](https://docs.1c-bitrix.ru/pages/framework/routing.html): Настройка маршрутизации URL, правила роутинга
- [Контроллеры](https://docs.1c-bitrix.ru/pages/framework/controllers.html): Создание и использование контроллеров, обработка запросов
- [Пре- и постфильтры](https://docs.1c-bitrix.ru/pages/framework/pre-post-filters.html): Фильтры выполнения для контроллеров
- [Request и Response](https://docs.1c-bitrix.ru/pages/framework/request-response.html): Работа с объектами запроса и ответа, HTTP-заголовки, параметры
- [Service Locator](https://docs.1c-bitrix.ru/pages/framework/service-locator.html): Паттерн Service Locator, регистрация и получение сервисов
- [Сессии](https://docs.1c-bitrix.ru/pages/framework/sessions.html): Управление сессиями пользователя
- [Cookie-файлы](https://docs.1c-bitrix.ru/pages/framework/cookies.html): Работа с cookie: чтение, запись, удаление
- [Валидация](https://docs.1c-bitrix.ru/pages/framework/validation.html): Валидация входных данных и форм
- [Результат работы и ошибки](https://docs.1c-bitrix.ru/pages/framework/results-and-errors.html): Объекты Result и Error, обработка ошибок
- [Компоненты](https://docs.1c-bitrix.ru/pages/framework/components.html): Компонентная архитектура, создание и подключение компонентов
- [Расширения](https://docs.1c-bitrix.ru/pages/framework/extensions.html): JS/CSS-расширения (Extensions), подключение клиентских ресурсов
- [Объект приложения и контекст](https://docs.1c-bitrix.ru/pages/framework/app-and-context.html): Глобальный объект Application, контекст выполнения
- [Агенты и фоновые задачи](https://docs.1c-bitrix.ru/pages/framework/background-jobs.html): Планировщик агентов, фоновые и отложенные задачи
- [События](https://docs.1c-bitrix.ru/pages/framework/events.html): Система событий: подписка, генерация, обработчики
- [Очереди сообщений](https://docs.1c-bitrix.ru/pages/framework/messenger.html): Работа с очередями сообщений (Message Queue / Messenger)
- [Временное хранение](https://docs.1c-bitrix.ru/pages/framework/storage.html): Временное хранилище данных в рамках запроса
- [Консольные команды](https://docs.1c-bitrix.ru/pages/framework/console-commands.html): Создание и выполнение CLI-команд

## База данных

- [Конфигурация](https://docs.1c-bitrix.ru/pages/database/configuration.html): Настройка подключения к базе данных, конфигурация соединений
- [Выполнение запросов](https://docs.1c-bitrix.ru/pages/database/query-execution.html): Выполнение SQL-запросов через объект Connection
- [Формирование запросов](https://docs.1c-bitrix.ru/pages/database/sql-helper-and-expression.html): SqlHelper и SqlExpression для безопасного формирования SQL
- [Построитель запросов](https://docs.1c-bitrix.ru/pages/database/query-builder.html): Fluent-интерфейс построения SQL-запросов
- [Отладка запросов](https://docs.1c-bitrix.ru/pages/database/sql-tracker.html): SqlTracker — профилирование и отладка запросов к БД
- [Транзакции](https://docs.1c-bitrix.ru/pages/database/transactions.html): Управление транзакциями, вложенные транзакции
- [NoSQL](https://docs.1c-bitrix.ru/pages/database/nosql.html): Работа с NoSQL-хранилищами (Redis, Memcache)
- [HandlerSocket](https://docs.1c-bitrix.ru/pages/database/handlersocket.html): Высокопроизводительный доступ к MySQL через HandlerSocket

## ORM

- [Концепция ORM](https://docs.1c-bitrix.ru/pages/orm/orm-concepts.html): Основные концепции ORM Bitrix Framework: сущности, поля, таблицы
- [Операции с сущностями и события](https://docs.1c-bitrix.ru/pages/orm/entity-operations.html): CRUD-операции, события add/update/delete в ORM
- [Объекты](https://docs.1c-bitrix.ru/pages/orm/objects.html): Объекты сущностей, доступ к полям и методам
- [Коллекции](https://docs.1c-bitrix.ru/pages/orm/collections.html): Работа с коллекциями объектов ORM
- [Отношения между сущностями](https://docs.1c-bitrix.ru/pages/orm/entity-relations.html): Reference, OneToMany, ManyToMany — связи сущностей
- [Аннотации классов](https://docs.1c-bitrix.ru/pages/orm/annotations.html): Аннотации для IDE-автодополнения в ORM
- [Выборка данных](https://docs.1c-bitrix.ru/pages/orm/querying-data.html): Методы getList, getByPrimary, выборка с фильтрацией и сортировкой
- [Построитель запросов](https://docs.1c-bitrix.ru/pages/orm/query-builder.html): ORM Query Builder — сложные выборки, JOIN-ы, агрегация

## Основы CMS

- [Сайты](https://docs.1c-bitrix.ru/pages/cms-basics/sites.html): Управление сайтами: создание, настройка, мультисайтовость
- [Шаблоны сайтов](https://docs.1c-bitrix.ru/pages/cms-basics/site-templates.html): Разработка и подключение шаблонов сайта
- [Шаблоны страницы](https://docs.1c-bitrix.ru/pages/cms-basics/page-templates.html): Шаблоны отдельных страниц, layout-структура
- [Работа с почтой](https://docs.1c-bitrix.ru/pages/cms-basics/mail.html): Отправка e-mail через почтовые события и шаблоны писем
- [Работа с СМС](https://docs.1c-bitrix.ru/pages/cms-basics/sms.html): Отправка SMS-уведомлений через SMS-сервисы
- [Пользователи](https://docs.1c-bitrix.ru/pages/cms-basics/users.html): API для работы с пользователями: регистрация, авторизация, свойства
- [Группы пользователей](https://docs.1c-bitrix.ru/pages/cms-basics/user-groups.html): Управление группами пользователей и правами доступа
- [Хлебные крошки](https://docs.1c-bitrix.ru/pages/cms-basics/breadcrumbs.html): Формирование навигационных цепочек (breadcrumbs)
- [Меню](https://docs.1c-bitrix.ru/pages/cms-basics/menu.html): Работа с навигационными меню сайта
- [Постраничная навигация](https://docs.1c-bitrix.ru/pages/cms-basics/page-navigation.html): Пагинация списков, объект PageNavigation
- [Включаемые области](https://docs.1c-bitrix.ru/pages/cms-basics/includes.html): Подключаемые области контента (Include Areas)
- [Пользовательские поля](https://docs.1c-bitrix.ru/pages/cms-basics/userfields.html): Создание и использование пользовательских полей (UF)
- [Панель администрирования](https://docs.1c-bitrix.ru/pages/cms-basics/admin-panel.html): Разработка страниц административной панели

## Расширенные знания

- [Дата и время](https://docs.1c-bitrix.ru/pages/advanced/datetime.html): Класс Date/DateTime, работа с часовыми поясами
- [Локализация](https://docs.1c-bitrix.ru/pages/advanced/localization.html): Многоязычность, языковые файлы, перевод интерфейса
- [Отладка](https://docs.1c-bitrix.ru/pages/advanced/debug.html): Инструменты отладки: профилировщик, логи, трассировка
- [Резервное копирование](https://docs.1c-bitrix.ru/pages/advanced/backup.html): Создание резервных копий сайта и базы данных
- [Vue.js](https://docs.1c-bitrix.ru/pages/advanced/vue.html): Использование Vue.js в компонентах и UI-виджетах Bitrix
- [Многосайтовость](https://docs.1c-bitrix.ru/pages/advanced/multisite.html): Настройка нескольких сайтов на одном ядре
- [Логгеры](https://docs.1c-bitrix.ru/pages/advanced/logger.html): Логирование событий, PSR-3-совместимые логгеры
- [Идентификатор UUID](https://docs.1c-bitrix.ru/pages/advanced/uuid.html): Генерация и работа с UUID
- [Итератор](https://docs.1c-bitrix.ru/pages/advanced/stepper.html): Stepper — пошаговая обработка больших объёмов данных
- [Работа с изображениями](https://docs.1c-bitrix.ru/pages/advanced/images.html): Изменение размеров, обрезка и обработка изображений
- [HTTP-клиент](https://docs.1c-bitrix.ru/pages/advanced/http-client.html): Выполнение HTTP-запросов к внешним сервисам
- [Геолокация](https://docs.1c-bitrix.ru/pages/advanced/geolocation.html): Определение местоположения пользователя по IP
- [Нумератор](https://docs.1c-bitrix.ru/pages/advanced/numerator.html): Генерация уникальных порядковых номеров (счётчики)
- [Пользовательские соглашения](https://docs.1c-bitrix.ru/pages/advanced/user-consent.html): Управление согласиями пользователей на обработку данных

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

- [Права доступа](https://docs.1c-bitrix.ru/pages/security/access-control.html): Контроль доступа, права модулей и задач
- [XSS](https://docs.1c-bitrix.ru/pages/security/xss.html): Защита от межсайтового скриптинга, экранирование вывода
- [CSRF и SSRF](https://docs.1c-bitrix.ru/pages/security/csrf-ssrf.html): Защита от CSRF- и SSRF-атак, токены проверки
- [SQL-инъекции](https://docs.1c-bitrix.ru/pages/security/sql-injection.html): Предотвращение SQL-инъекций, параметризованные запросы
- [Защищенные cookie](https://docs.1c-bitrix.ru/pages/security/secure-cookies.html): Настройка безопасных cookie (HttpOnly, Secure, SameSite)
- [JWT](https://docs.1c-bitrix.ru/pages/security/jwt.html): Работа с JSON Web Token для авторизации
- [Санитайзер](https://docs.1c-bitrix.ru/pages/security/sanitizer.html): Очистка HTML-контента от опасных тегов
- [Firewall](https://docs.1c-bitrix.ru/pages/security/firewall.html): Веб-приложение Firewall (WAF) в Bitrix Framework
- [Защита от фреймов](https://docs.1c-bitrix.ru/pages/security/frame-protection.html): Заголовки X-Frame-Options, защита от Clickjacking
- [CAPTCHA](https://docs.1c-bitrix.ru/pages/security/captcha.html): Встроенная CAPTCHA для защиты форм
- [Проактивная защита](https://docs.1c-bitrix.ru/pages/security/proactive-security.html): Модуль проактивной защиты: фильтр запросов, блокировки
- [Двухэтапная авторизация](https://docs.1c-bitrix.ru/pages/security/two-factor-auth.html): Настройка двухфакторной аутентификации (2FA)

## Производительность

- [Кеширование](https://docs.1c-bitrix.ru/pages/performance/caching.html): Типы кеша (managed, memcache, redis), теги кеша, управляемый кеш
- [Композитный сайт](https://docs.1c-bitrix.ru/pages/performance/composite-site.html): Технология Composite Site для ускорения загрузки страниц
- [Шардинг](https://docs.1c-bitrix.ru/pages/performance/sharding.html): Горизонтальное масштабирование базы данных — шардинг
- [Репликация и кластер](https://docs.1c-bitrix.ru/pages/performance/replication-and-clustering.html): Настройка репликации MySQL и кластерного режима
- [Сессия в разделенном режиме](https://docs.1c-bitrix.ru/pages/performance/hot-and-cold-session.html): Разделение сессии на «горячую» и «холодную» части
- [Как оптимизировать запросы к базе данных](https://docs.1c-bitrix.ru/pages/performance/query-optimization.html): Практические советы по оптимизации SQL-запросов

## Модули

### Информационные блоки (iblock)

- [Введение и базовые концепции](https://docs.1c-bitrix.ru/pages/modules/iblocks/overview.html): Что такое инфоблоки, типы, разделы, элементы
- [Схема работы инфоблоков и основные объекты](https://docs.1c-bitrix.ru/pages/modules/iblocks/architecture.html): Архитектура модуля iblock, ключевые классы и таблицы
- [Работа с инфоблоками через API](https://docs.1c-bitrix.ru/pages/modules/iblocks/api.html): CIBlock, CIBlockElement, CIBlockSection — выборка и изменение данных
- [Производительность и частые ошибки](https://docs.1c-bitrix.ru/pages/modules/iblocks/performance.html): Оптимизация работы с инфоблоками, типичные ошибки разработчиков