Архитектура платформы, окружение и деплой, стандарты кода, работа с легаси.
Справочник разработчика 1С-Битрикс: разбор архитектуры и готовые кейсы
Понятное руководство по 1С-Битрикс для разработчиков. Объясняем устройство ядра, D7, ORM и кастомизацию компонентов простыми словами на реальных примерах.
Разделы документации
Одиннадцать разделов: от архитектуры платформы и ядра D7 до безопасности, производительности и эксплуатации. Внутри каждого - статьи с разбором механики, примерами кода и частыми ошибками.
Application и контекст, ORM, контроллеры, события и агенты, служебные подсистемы.
Элементы, разделы и свойства, старый API и ORM, пользовательские поля.
Компоненты 2.0, шаблоны сайта, меню и навигация, композитный сайт.
Каталог и продажи, скидки и склады, валюты, личный кабинет и кассы.
Свои модули, веб-формы, списки, рассылки, реклама, поиск, соцсервисы.
Ядро BX, расширения, UI-библиотека, BitrixVue 3, админ-интерфейс.
Авторизация и сессии, группы, права на разделы и модули, внешние источники входа.
XSS и SQL-инъекции, CSRF и права доступа, шифрование, JWT, капча.
Оптимизация запросов, все виды кеша, композит, кластер, монитор, база.
Обмен с 1С, HTTP-клиент, SMS и очереди, real-time через Pull.
Настройка сервера, Sphinx и доменная авторизация, тестирование и выкладка.
Решения частых задач
Больше четырёхсот страниц с готовыми решениями: рецепт, разбор механики или диагностика по симптому. Ниже - подтемы, к которым обращаются чаще всего.
Выгрузка товаров, характеристики и свойства, дубли, долгий обмен и его обрывы.
Варианты товара: свойства выбора, картинки, цены и наличие, создание из кода.
Настройка отбора, числа рядом со значениями, фильтр по свойствам предложений.
Белая страница, ошибки 500 и 502, нехватка памяти, кодировки и разбор по журналам.
Поиск узких мест, кэш и его сброс, картинки витрины, проверка перед акцией.
Форма входа, регистрация, восстановление пароля, профиль и защита от перебора.
Старое ядро и ORM, сложные фильтры, постраничная навигация, кэш выборки.
Заказ из кода, статусы и свойства, оплаты и отгрузки, кабинет покупателя, отчёты.
С чего начать
Четыре статьи, которые дают опору перед всеми остальными: как устроена платформа, что даёт ядро D7 и как данные попадают на страницу.
Два ядра, структура файлов, жизненный цикл запроса и отложенные функции.
Application и Context, запрос и ответ, контроллеры, события, Result.
Сущности вместо SQL: выборки, фильтры, связи, транзакции.
Как данные попадают на страницу и где заканчивается кеш.
Что внутри
Из чего состоит каждая статья справочника и чем она отличается от официальной документации.
Сначала - как это работает
Каждая статья начинается с объяснения механики: что происходит внутри платформы и почему это устроено именно так.
Примеры с результатом
Код с комментариями и показом того, что он вернёт. Несколько способов на одну задачу и сопоставление старого API с D7.
Частые ошибки
Симптом и причина: почему выборка вернула лишние строки, куда пропали свойства и отчего кеш переписывается на каждом запросе.
Ссылки на первоисточники
В конце каждой статьи - ссылки на официальную документацию и учебные курсы, чтобы можно было проверить и углубиться.
Частые вопросы
Короткие ответы на то, что обычно спрашивают перед началом работы со справочником.
Чем этот справочник отличается от официальной документации?
Официальная документация перечисляет методы и параметры. Здесь сначала объясняется механика: что платформа делает внутри и почему устроена именно так. Дальше идут примеры с показом результата, сопоставление старого API с D7 и разбор ошибок, на которые чаще всего наступают. Ссылки на первоисточники есть в конце каждой статьи.
С чего начать изучение разработки на 1С-Битрикс?
С архитектуры платформы: двух ядер, структуры файлов и жизненного цикла запроса. Без этой картины остальное выглядит набором несвязанных приёмов. Дальше - ядро D7 и работа с инфоблоками, потом компоненты и шаблоны.
Обязательно ли переходить на D7, если проект работает на старом ядре?
Нет. Оба ядра работают одновременно, и переписывать проект целиком не нужно. Разумный путь - новый код писать на D7, а старый переводить по мере правок. В статьях старый и новый API показаны рядом, чтобы такой перевод был механическим.
Какие версии платформы описаны?
Материал ориентирован на актуальные редакции «1С-Битрикс: Управление сайтом» с ядром D7. Приёмы старого ядра описаны там, где они до сих пор встречаются в живых проектах: часть API без D7-замены остаётся единственным рабочим вариантом.
Можно ли использовать примеры кода в своих проектах?
Да. Примеры написаны как заготовки под доработку: с проверками входных данных и без сокращений ради краткости. Перед переносом в проект замените идентификаторы инфоблоков и коды свойств на свои.
Где искать решение конкретной задачи?
В слое решений: у каждого раздела есть подтемы, а внутри них - страницы под конкретную задачу или симптом. Рецепт отвечает «как сделать», разбор - «как это устроено целиком», диагностика - «почему не работает» с причинами по убыванию частоты.
Как быстро найти нужную статью?
Поиском в шапке: он ищет по тексту всех статей, включая примеры кода. Если тема известна лишь примерно, начните с раздела в меню слева - внутри каждого раздела статьи идут от общего к частному.