Модули 1С-Битрикс: установка, обновление, ошибки

Коротко

Управление модулями Битрикс сосредоточено в административной части сайта: список установленных модулей с версиями находится в разделе «Настройки» → «Настройки продукта» → «Модули», параметры каждого модуля — в «Настройках модулей», а сторонние решения устанавливаются и обновляются через Marketplace. Модуль — это самостоятельная часть системы со своими файлами, таблицами в базе и настройками: инфоблоки, интернет-магазин, поиск, веб-формы, SEO, проактивная защита и десятки партнёрских решений.

Сайт на 1С-Битрикс обычно ломается не из-за самого модуля, а из-за порядка действий: обновление без резервной копии, установка решения, несовместимого с версией PHP или главного модуля, правки в файлах модуля, которые перезаписываются при обновлении. Если соблюдать простую последовательность — копия, проверка совместимости, обновление на тестовой копии, затем на рабочем сайте — риск сводится к минимуму.

Задача	Где в админке	На что обратить внимание
Посмотреть модули и версии	Настройки → Настройки продукта → Модули	Версия и дата каждого модуля
Изменить настройки модуля	Настройки → Настройки продукта → Настройки модулей	Настройки могут быть разными для сайтов
Установить решение	Marketplace → каталог решений	Совместимость, редакция, отзывы
Обновить ядро и модули	Раздел обновлений платформы	Резервная копия, лицензия активна
Обновить партнёрские решения	Раздел обновления решений Marketplace	Срок обновлений у разработчика

Основная мысль

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

Владельцы сайтов часто переносят привычки из WordPress: нашли решение, установили, посмотрели, удалили. В Битриксе установка модуля создаёт таблицы, регистрирует обработчики событий, копирует компоненты и файлы административной части. Удаление не всегда возвращает сайт к исходному состоянию, а обновление одного модуля может потребовать обновления главного.

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

Битрикс: где модули и как они устроены

В административной части

Полный список установленных модулей открывается в разделе «Настройки» → «Настройки продукта» → «Модули». Для каждого модуля там указаны название, версия, дата версии и статус. Отсюда же модули устанавливаются и удаляются. Партнёрские решения из Marketplace отображаются отдельно — в разделе установленных решений Marketplace.

В файловой системе

Системные и партнёрские модули лежат в папке /bitrix/modules/, собственные модули разработчика — в /local/modules/. Идентификатор партнёрского модуля состоит из кода партнёра и названия через точку. Номер версии модуля хранится в файле install/version.php внутри его папки.

/bitrix/modules/main/          — главный модуль
/bitrix/modules/iblock/        — информационные блоки
/bitrix/modules/partner.module/ — решение из Marketplace
/local/modules/company.module/  — собственный модуль

Папка /local/ не перезаписывается системой обновлений, поэтому доработки держат именно там, а не в /bitrix/.

Из чего состоит модуль

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

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

Какие модули есть в вашей редакции

Набор системных модулей зависит от редакции лицензии. Например, модуль интернет-магазина входит в редакции начиная с «Малого бизнеса», а в «Старте» и «Стандарте» его нет. Если нужный модуль отсутствует в списке, причина обычно в редакции, и решается она переходом на старшую. Как выбрать редакцию под задачи, разобрано в статье о том, какую редакцию 1С-Битрикс выбрать.

Битрикс: настройки модуля

Большинство модулей имеют собственную страницу параметров. Её открывают в разделе «Настройки» → «Настройки продукта» → «Настройки модулей», выбрав модуль из списка.

Что обычно настраивают

Модуль	Типичные настройки
Главный модуль	Почта, кэширование, адрес сайта, параметры авторизации
Информационные блоки	Работа с изображениями, права, ЧПУ
Интернет-магазин	Валюты, статусы заказов, оплата и доставка
Поиск	Индексация, морфология, исключения
Проактивная защита	Фильтр, журнал вторжений, контроль активности
Поисковая оптимизация	Карта сайта, robots.txt, связь с Вебмастером

Настройки для нескольких сайтов

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

Права доступа к модулю

На вкладке доступа в настройках модуля задаётся, какие группы пользователей могут работать с ним. Это полезно, когда контент-менеджеру нужен доступ к инфоблокам, но не к интернет-магазину и настройкам безопасности.

Установка модулей Битрикс

Как установить модуль Битрикс из Marketplace

Marketplace — каталог готовых решений от партнёров 1С-Битрикс: интеграции с сервисами, платёжные системы, SEO-инструменты, шаблоны. Порядок установки такой:

Сделайте резервную копию файлов и базы.
Проверьте в карточке решения совместимость с вашей редакцией, версией главного модуля и PHP.
Установите решение через каталог Marketplace в административной части. Для платного решения потребуется купон или покупка.
После загрузки запустите установку модуля и пройдите мастер, если он есть.
Проверьте основные страницы сайта, корзину и формы.

Установка вручную

Иногда решение поставляется архивом. Его распаковывают в /bitrix/modules/ или /local/modules/, после чего модуль появляется в списке модулей со статусом «не установлен». Установка запускается кнопкой в списке — она выполнит скрипт установки модуля. Имя папки должно совпадать с идентификатором модуля, иначе установщик его не увидит.

Битрикс-модуль из Marketplace: как выбирать

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

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

У платных решений отдельно проверьте условия обновлений. Как правило, обновления доступны в течение оплаченного периода, а дальше их нужно продлевать у разработчика решения. Если решение давно не обновлялось, а сайт регулярно получает обновления платформы, рано или поздно между ними возникнет несовместимость. В таком случае дешевле заранее найти альтернативу, чем чинить сайт после очередного обновления ядра.

Обновления модулей Битрикс

Два вида обновлений

Системные модули — главный, инфоблоки, интернет-магазин и другие — обновляются через систему обновлений платформы. Партнёрские решения — через раздел обновления решений Marketplace. Обновления платформы доступны, пока действует период обновлений лицензии; после его окончания лицензию нужно продлить. Как это устроено, разобрано в статье о продлении лицензии Битрикс.

Битрикс: версии модулей и совместимость

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

Как обновить модули Битрикс безопасно

Сделайте полную резервную копию файлов и базы данных.
Проверьте, есть ли в /bitrix/ правки в файлах модулей и системных компонентов. Всё, что там изменено вручную, будет перезаписано.
Разверните копию сайта и выполните обновление сначала на ней.
Обновите сначала систему обновлений и главный модуль, затем остальные модули.
Проверьте ключевые сценарии: каталог, корзина, оформление заказа, формы, обмен с 1С, личный кабинет.
Повторите обновление на рабочем сайте в период минимальной нагрузки.
Очистите кэш и проверьте журнал ошибок.

Подробно о том, как обновлять сайт, в котором много доработок, написано в статье об обновлении 1С-Битрикс без потери доработок.

Откат

Штатной кнопки отката обновлений нет. Вернуть сайт к состоянию до обновления можно только из резервной копии, поэтому копию делают перед каждым обновлением, а не раз в месяц. О резервном копировании и его проверке — в статье про резервное копирование сайта.

Ошибки модуля Битрикс и что с ними делать

Типичные сообщения и причины

Симптом	Частая причина	Что сделать
Модуль не установлен	Модуль удалён или не установлен после загрузки	Установить в списке модулей или убрать вызов из шаблона
Требуется более новая версия главного модуля	Решение новее, чем ядро сайта	Обновить платформу или выбрать версию решения
Белый экран или ошибка 500 после обновления	Несовместимость с версией PHP, прерванное обновление	Смотреть журнал ошибок PHP, восстановить из копии
Демо-период решения закончился	Платный модуль установлен в демо-режиме	Купить лицензию или удалить решение
Класс не найден	Обновление прошло частично, повреждены файлы	Повторить обновление, сверить файлы с копией
Компонент выводит пустоту	Изменились параметры или шаблон компонента	Проверить параметры и кастомный шаблон

Порядок диагностики

Включите вывод ошибок только для администратора или смотрите журнал ошибок PHP на хостинге.
Запустите проверку системы в разделе инструментов административной части: она покажет проблемы с настройками сервера и базы.
Проверьте, какие модули обновлялись последними, по датам версий в списке модулей.
Отключите подозрительный партнёрский модуль на тестовой копии и проверьте, уходит ли ошибка.
Если сайт не открывается вовсе, восстановите его из резервной копии и разбирайтесь на копии.

После исправления очистите кэш: старые данные в кэше иногда продолжают выдавать ошибку, хотя причина уже устранена. Как работать с кэшем, рассказано в статье про кэш в 1С-Битрикс.

Системные модули, которые стоит проверить на каждом сайте

Часть системных модулей установлена почти на каждом сайте, но настроена по умолчанию или не настроена вовсе. Короткая проверка этих модулей даёт заметный эффект для скорости, безопасности и SEO.

Проактивная защита

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

Монитор производительности

Монитор производительности показывает, какие страницы и компоненты работают медленно, и даёт оценку конфигурации сервера. Его запускают на время теста, а не держат включённым постоянно: сам сбор статистики нагружает сайт.

Поисковая оптимизация

Модуль SEO помогает генерировать карту сайта, редактировать robots.txt и шаблоны метаданных. Проверьте, что карта сайта обновляется и в неё не попадают служебные разделы.

Резервное копирование

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

Сценарии работы с модулями

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

Службы доставки и платёжные системы в 1С-Битрикс подключаются через модуль интернет-магазина или отдельные партнёрские решения. Перед установкой проверьте, нет ли нужной службы среди встроенных обработчиков. Если есть, партнёрский модуль не нужен. Если нет, выбирайте решение, которое поддерживается разработчиком службы или партнёром с актуальными обновлениями, и тестируйте оформление заказа на копии сайта.

Сайт на готовом решении

Готовое решение из Marketplace — это тоже модуль, который содержит шаблон, компоненты и мастер установки. Его обновления выходят отдельно от обновлений платформы. Если шаблон решения правили напрямую, обновление решения перезапишет изменения, поэтому правки переносят в копию шаблона или в /local/ заранее.

Интеграция с внешней системой

Обмен с CRM, складом или сервисом рассылок лучше оформлять собственным модулем в /local/modules/, а не кодом в файле init.php. Модуль можно отключить, у него есть свои настройки, а его код не смешивается с остальными доработками. Это упрощает поддержку и передачу проекта другому разработчику.

Удаление модулей

Что происходит при удалении

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

Перед удалением проверьте

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

Системные модули вроде главного, инфоблоков или интернет-магазина на работающем сайте не удаляют: от них зависят каталог, заказы и контент.

Собственные модули и доработки

Почему доработки выносят в модуль

Код, дописанный прямо в файлы системных модулей или компонентов в /bitrix/, пропадает при первом обновлении. Правильная практика — размещать доработки в /local/: собственные компоненты, шаблоны, обработчики событий и модули. Тогда ядро можно обновлять без страха потерять изменения.

Когда нужен собственный модуль

интеграция с внешним сервисом, CRM или складской системой;
набор обработчиков событий, который удобно включать и выключать;
собственные страницы в административной части;
функциональность, которую нужно переносить между проектами.

Сценарий: сайт с правками в ядре

Типичная ситуация: сайт годами не обновлялся, потому что предыдущий разработчик правил файлы в /bitrix/modules/ и /bitrix/components/. Обновление в такой ситуации начинают с аудита: сравнивают файлы с эталонной версией, переносят найденные правки в /local/, проверяют на копии и только потом обновляют платформу.

Регулярное обслуживание модулей

Модули лучше обслуживать по графику, а не тогда, когда что-то сломалось. Для небольшого сайта или магазина достаточно простого плана.

Периодичность	Что делать
Раз в месяц	Проверить доступные обновления, журнал ошибок и журнал вторжений
Раз в квартал	Установить обновления на тестовой копии, затем на рабочем сайте
Раз в полгода	Пересмотреть список партнёрских решений, удалить неиспользуемые
Перед окончанием периода обновлений	Продлить лицензию и обновить платформу до актуальной версии
После смены версии PHP на хостинге	Запустить проверку системы и проверить ключевые страницы

Кто этим занимается

Проверку обновлений и журналов может делать администратор сайта. Установку обновлений на сайтах с доработками, интеграциями и обменом с 1С лучше поручать разработчику, который знает проект: он заранее увидит конфликты с кастомным кодом. Поддержка сайта обычно оплачивается почасово, ориентир — от 2 000 ₽ в час, а объём работ зависит от числа доработок и давности последнего обновления.

На чём опасно экономить

Типичные ошибки

Обновление без резервной копии и без тестовой копии сайта.
Правки в файлах модулей и системных компонентов в /bitrix/.
Установка нескольких решений с одинаковой функциональностью.
Модули в демо-режиме, которые перестают работать после окончания срока.
Обновление партнёрских модулей без проверки совместимости с ядром.
Отложенное продление лицензии, из-за которого ядро годами не обновляется.
Удаление модуля без проверки, где используются его компоненты.

Чек-лист

Составлен список установленных модулей с версиями и назначением.
Партнёрские решения, которые не используются, удалены.
Доработки находятся в /local/, в /bitrix/ нет ручных правок.
Лицензия и период обновлений активны.
Версия PHP на хостинге соответствует требованиям ядра и модулей.
Перед каждым обновлением делается резервная копия.
Обновления сначала проверяются на тестовой копии.
После обновления проверяются каталог, корзина, формы и обмен с 1С.
Права доступа к модулям настроены по группам пользователей.

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

Где модули в Битриксе?

В административной части: «Настройки» → «Настройки продукта» → «Модули». В файлах — в папках /bitrix/modules/ и /local/modules/.

Как установить модуль Битрикс?

Через каталог Marketplace в административной части или вручную: загрузить папку модуля в /bitrix/modules/ или /local/modules/ и нажать «Установить» в списке модулей. Перед установкой сделайте резервную копию.

Как посмотреть версии модулей в Битриксе?

В списке модулей рядом с каждым указаны версия и дата. Для партнёрских решений версии видны в разделе установленных решений Marketplace.

Как обновить модули Битрикс, если лицензия истекла?

Сначала продлить лицензию: без активного периода обновлений система обновлений платформы недоступна. Затем обновлять по шагам, начиная с главного модуля.

Можно ли обновить один модуль, не обновляя остальные?

Технически система позволяет выбрать модули для обновления, но зависимости между ними никуда не деваются. Безопаснее обновлять всё сразу на тестовой копии и проверять результат.

Что делать при ошибке модуля Битрикс после обновления?

Посмотреть журнал ошибок PHP, запустить проверку системы, выяснить, какой модуль обновлялся последним. Если сайт не работает, восстановить его из резервной копии и искать причину на копии.

Где находятся настройки модуля в Битриксе?

В разделе «Настройки» → «Настройки продукта» → «Настройки модулей». У некоторых партнёрских решений есть собственный пункт в меню административной части.

Безопасно ли ставить бесплатные модули из Marketplace?

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

Можно ли установить модуль интернет-магазина на редакцию «Старт»?

Нет, набор системных модулей определяется редакцией. Интернет-магазин доступен начиная с «Малого бизнеса», поэтому для него понадобится переход на эту или старшую редакцию.

Почему после удаления модуля остались его таблицы и файлы?

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

Итог

Модули — основа 1С-Битрикс: из них собраны каталог, магазин, формы, поиск и защита. Работать с ними несложно, если знать, где они находятся, как проверять версии и совместимость и почему доработки нужно держать в /local/.

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

Если нужно разобраться с модулями, обновить платформу без потери доработок или исправить ошибку после обновления, я как частный разработчик возьму это в рамках доработки сайта на 1С-Битрикс. Работаю напрямую, без посредников.