К статье
Практический материал

Администрирование · 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. 1
    Авторизуйтесь в административном разделе с правами администратора
  2. 2
    Откройте Настройки → Настройки продукта → Модули
  3. 3
    Найдите нужный модуль в списке или через фильтр
  4. 4
    Считайте значение в колонке «Версия»
  5. 5
    При необходимости сверьте с версией главного модуля main

Если в списке модуль отображается, но не установлен (стоит признак удаления), версия может быть неактуальной — это версия файлов на диске, а не работающего модуля. Проверяйте статус установки в той же таблице.

Способ 2: проверить файл version.php на сервере

Когда админка недоступна (сайт выдаёт ошибку, нет доступа к панели), версию можно посмотреть напрямую в файловой системе. Откройте по FTP, SSH или через файловый менеджер хостинга папку /bitrix/modules/идентификатор_модуля/ и найдите файл version.php.

Внутри файла находится массив с двумя ключами: VERSION — номер версии и VERSION_DATE — дата её выпуска. Например, для главного модуля путь будет /bitrix/modules/main/version.php.

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), но нет доступа ни к админке, ни к файлам — например, при работе через панель хостинга.

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

sql
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
<?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 на всём сайте.

Файл version.php

Работает без доступа в админку, нужен только FTP/SSH. Показывает версию файлов, которая может отличаться от версии в базе.

Запрос к базе данных

Показывает фактически установленную версию. Требует доступа к БД и аккуратности: только SELECT-запросы, без изменения данных.

API (CModule)

Подходит для автоматизации и массового сбора данных. Требует навыков PHP и аккуратного обращения со служебными скриптами.

Типичные ошибки и проверка результата

Частая ошибка — путать версию модуля с версией редакции продукта («Управление сайтом», «Корпоративный портал»). Редакция определяет набор доступных модулей, но не является версией. Другая ошибка — сообщать в поддержку версию из файла, когда в базе стоит другая: всегда сверяйте оба значения при подозрении на незавершённое обновление.

Ещё одна проблема — поиск модуля по названию вместо идентификатора. Названия локализованы и могут отличаться, а идентификатор (main, sale, iblock) един для всех установок.

Типичные ошибки
01
Сообщать версию редакции вместо версии модуля — поддержка получает неверные данные, диагностика затягивается
02
Смотреть только version.php и не замечать расхождение с базой — признак незавершённого обновления остаётся скрытым
03
Редактировать version.php ради «отката» версии — ломается механизм обновлений и целостность ядра
04
Искать модуль по русскому названию в файловой системе — папки модулей названы латинскими идентификаторами
Контрольные точки

Как проверить результат

Версия в админке и в version.php
Норма

Значения совпадают

Тревожный признак

Версии различаются — обновление не завершено, выполните отложенные скрипты

Запись модуля в b_module
Норма

Строка с идентификатором модуля существует и версия заполнена

Тревожный признак

Записи нет — модуль не установлен, хотя файлы могут лежать на диске

Работа сайта после проверки
Норма

Сайт и админка открываются без ошибок

Тревожный признак

Появились ошибки — проверьте, не изменялись ли файлы ядра

Когда данные о версии нельзя получить самостоятельно

Если сайт не открывается, доступа к хостингу нет, а база данных недоступна, самостоятельно узнать версию не получится. В этом случае запросите доступ у хостинг-провайдера или у разработчика, обслуживающего проект. Не пытайтесь «восстановить» доступ правкой файлов конфигурации без резервной копии.

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

Итог

Что важно запомнить

Версия модуля видна в админке (Настройки → Модули), в файле 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: ручная правка таблицы модулей нарушит работу системы. Выполняйте только чтение и работайте под учётной записью с минимально необходимыми правами.

Нужно ли знать версию модуля перед обращением в поддержку?

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