Администрирование · 10 мин
Как узнать версию модуля в 1С-Битрикс
Как узнать версию модуля в 1С-Битрикс: через админку, файл version.php, базу данных и API. Проверка версий модулей обмена с 1С и решение типичных проблем.
Знание точной версии модуля в 1С-Битрикс требуется при обновлении системы, диагностике ошибок обмена с 1С, обращении в техническую поддержку и проверке совместимости решений из Маркетплейса. Версия модуля — это не версия всей системы: каждый модуль (главный, интернет-магазин, обмен с 1С и другие) обновляется и нумеруется отдельно.
Есть несколько рабочих способов узнать версию: через административный раздел, через служебный файл version.php в папке модуля, запросом к базе данных и программно через API. Выбор зависит от того, есть ли у вас доступ в админку, работает ли сайт и какой именно модуль нужно проверить.
Что такое версия модуля и где она хранится
В 1С-Битрикс каждый модуль имеет уникальный идентификатор (например, main — главный модуль, sale — интернет-магазин, iblock — информационные блоки, catalog — торговый каталог). Для каждого модуля версия фиксируется в двух местах: в файле version.php внутри папки модуля и в таблице b_module базы данных.
Важно различать версию ядра (модуль main) и версии прикладных модулей. Когда в поддержке просят «версию Битрикса», чаще всего имеют в виду версию главного модуля, но для диагностики обмена с 1С понадобится версия конкретного модуля интеграции.
Способ 1: посмотреть версию в административном разделе
Самый простой путь — список установленных модулей в панели управления. Перейдите в раздел Настройки → Настройки продукта → Модули. Откроется таблица со всеми установленными модулями, где для каждого указаны идентификатор, название и текущая версия.
Чтобы быстро найти нужный модуль, используйте фильтр по идентификатору или названию. Например, для проверки модуля обмена с 1С найдите строку с идентификатором модуля интеграции и посмотрите значение в колонке «Версия».
- 1Авторизуйтесь в административном разделе с правами администратора
- 2Откройте Настройки → Настройки продукта → Модули
- 3Найдите нужный модуль в списке или через фильтр
- 4Считайте значение в колонке «Версия»
- 5При необходимости сверьте с версией главного модуля main
Если в списке модуль отображается, но не установлен (стоит признак удаления), версия может быть неактуальной — это версия файлов на диске, а не работающего модуля. Проверяйте статус установки в той же таблице.
Способ 2: проверить файл version.php на сервере
Когда админка недоступна (сайт выдаёт ошибку, нет доступа к панели), версию можно посмотреть напрямую в файловой системе. Откройте по FTP, SSH или через файловый менеджер хостинга папку /bitrix/modules/идентификатор_модуля/ и найдите файл version.php.
Внутри файла находится массив с двумя ключами: VERSION — номер версии и VERSION_DATE — дата её выпуска. Например, для главного модуля путь будет /bitrix/modules/main/version.php.
cat /bitrix/modules/main/version.php
// Пример содержимого:
// $arModuleVersion = array(
// "VERSION" => "24.100.0",
// "VERSION_DATE" => "2026-05-10 10:00:00"
// );Учитывайте важный нюанс: файл показывает версию файлов модуля на диске. Если обновление загрузилось, но скрипты обновления базы данных не выполнились, версия в файле и версия в базе могут различаться — это признак незавершённого обновления.
Способ 3: запрос к базе данных
Информация об установленных модулях хранится в таблице b_module. Этот способ полезен, когда есть доступ к базе (phpMyAdmin, консоль MySQL), но нет доступа ни к админке, ни к файлам — например, при работе через панель хостинга.
Выполните запрос, указав идентификатор нужного модуля. Результат покажет версию, зафиксированную в базе, — именно её система считает текущей установленной версией.
SELECT ID, VERSION FROM b_module WHERE ID = 'main';
-- Для просмотра всех модулей:
SELECT ID, VERSION FROM b_module ORDER BY ID;Если версия в таблице отличается от версии в version.php, значит обновление модуля завершилось не полностью. В этом случае перейдите на страницу обновлений (Настройки → Настройки продукта → Обновление системы) и завершите установку обновлений либо выполните отложенные скрипты.
Способ 4: получить версию программно через API
Для скриптов, плагинов и автоматической диагностики используйте API Битрикса. Класс CModule предоставляет методы для работы с модулями, а класс CSupportClient и служебные страницы позволяют получать сводную информацию.
<?php
require($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/prolog_before.php");
// Проверка, установлен ли модуль
if (CModule::IncludeModule("sale")) {
echo "Модуль sale установлен\n";
}
// Версия из базы данных
$rsModule = CModule::GetList();
while ($arModule = $rsModule->Fetch()) {
echo $arModule["ID"] . " — " . $arModule["VERSION"] . "\n";
}Программный способ удобен для сбора информации о всех модулях сразу — например, при подготовке отчёта для технической поддержки или при мониторинге нескольких сайтов. Запускайте такие скрипты из командной строки или через страницу «Командная PHP-строка» в админке (Настройки → Инструменты), не размещая их в публичном доступе.
Как узнать версию модуля обмена с 1С
Для сайтов, интегрированных с 1С, чаще всего нужна версия модуля обмена. В коробочных редакциях и решениях с интеграцией это может быть отдельный модуль (например, модуль интеграции от вендора) либо штатный функционал модуля sale. Точный идентификатор смотрите в документации к вашему решению обмена.
Порядок проверки тот же: найдите модуль в списке «Настройки → Модули» по идентификатору или откройте его version.php. Со стороны 1С версию механизма обмена смотрите в настройках узла обмена с сайтом — там указывается используемая версия протокола CommerceML, которая должна поддерживаться модулем на сайте.
Сравнение способов
Самый быстрый и безопасный способ. Подходит, когда сайт и панель управления работают. Не поможет при ошибке 500 на всём сайте.
Работает без доступа в админку, нужен только FTP/SSH. Показывает версию файлов, которая может отличаться от версии в базе.
Показывает фактически установленную версию. Требует доступа к БД и аккуратности: только SELECT-запросы, без изменения данных.
Подходит для автоматизации и массового сбора данных. Требует навыков PHP и аккуратного обращения со служебными скриптами.
Типичные ошибки и проверка результата
Частая ошибка — путать версию модуля с версией редакции продукта («Управление сайтом», «Корпоративный портал»). Редакция определяет набор доступных модулей, но не является версией. Другая ошибка — сообщать в поддержку версию из файла, когда в базе стоит другая: всегда сверяйте оба значения при подозрении на незавершённое обновление.
Ещё одна проблема — поиск модуля по названию вместо идентификатора. Названия локализованы и могут отличаться, а идентификатор (main, sale, iblock) един для всех установок.
Как проверить результат
Значения совпадают
Версии различаются — обновление не завершено, выполните отложенные скрипты
Строка с идентификатором модуля существует и версия заполнена
Записи нет — модуль не установлен, хотя файлы могут лежать на диске
Сайт и админка открываются без ошибок
Появились ошибки — проверьте, не изменялись ли файлы ядра
Когда данные о версии нельзя получить самостоятельно
Если сайт не открывается, доступа к хостингу нет, а база данных недоступна, самостоятельно узнать версию не получится. В этом случае запросите доступ у хостинг-провайдера или у разработчика, обслуживающего проект. Не пытайтесь «восстановить» доступ правкой файлов конфигурации без резервной копии.
Перед любыми действиями с файлами или базой сделайте резервную копию сайта и базы данных. Даже безобидный просмотр через файловый менеджер безопасен, но любые правки — только после бэкапа и с пониманием последствий.
Что важно запомнить
Версия модуля видна в админке (Настройки → Модули), в файле version.php папки модуля, в таблице b_module и через API. Расхождение версии в файле и в базе — признак незавершённого обновления. Файлы ядра не редактируют, а перед любыми действиями делают резервную копию.
Частые вопросы
Где посмотреть версию всей системы, а не отдельного модуля?
Версия системы — это версия главного модуля main. Она отображается в списке модулей, в файле /bitrix/modules/main/version.php, а также на стартовой странице раздела обновлений (Настройки → Настройки продукта → Обновление системы).
Почему версия в файле и в базе данных различаются?
Файлы обновились, а скрипты обновления базы не выполнились — обновление зависло на промежуточном этапе. Откройте страницу обновления системы и завершите установку, затем сверьте значения повторно.
Как узнать версию модуля, если нет доступа в админку?
Откройте по FTP или SSH файл version.php в папке модуля (/bitrix/modules/идентификатор/). Если есть доступ к базе данных, выполните SELECT из таблицы b_module по идентификатору модуля.
Как узнать версию модуля обмена с 1С?
Найдите идентификатор модуля интеграции в документации к вашему решению обмена и проверьте его версию стандартным способом — через список модулей или version.php. Со стороны 1С версия протокола обмена указывается в настройках узла обмена с сайтом.
Опасно ли выполнять SQL-запрос к таблице b_module?
Запрос на чтение (SELECT) безопасен и ничего не меняет в данных. Опасны запросы UPDATE и DELETE: ручная правка таблицы модулей нарушит работу системы. Выполняйте только чтение и работайте под учётной записью с минимально необходимыми правами.
Нужно ли знать версию модуля перед обращением в поддержку?
Да, это одно из первых данных, которые запрашивает поддержка. Подготовьте версию главного модуля, версию проблемного модуля и редакцию продукта — это заметно ускорит диагностику.