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

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

Механизм обновления в Битриксе устроен просто: система SiteUpdate загружает пакеты с сервера обновлений и применяет их к ядру и модулям. Однако под видимой простотой скрываются нюансы — зависимости между модулями, требования к версии PHP, кастомизированный код, который перезаписывается, и ограничения лицензии. Все эти моменты нужно учесть до старта.

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

Проверьте лицензию и окружение перед обновлением

Система обновлений Битрикса работает только при активной лицензии. Откройте «Настройки → Обновление платформы» и убедитесь, что лицензионный ключ введён и срок получения обновлений не истёк. Если лицензия закончилась, сервер обновлений откажет в загрузке, и единственный путь — продлить лицензию либо обновлять модуль вручную из дистрибутива, что требует аккуратности и доступа к файлам.

Второй критичный пункт — версия PHP и параметры сервера. Новые версии модулей могут требовать более свежий PHP, чем установлен у вас. Проверьте текущую конфигурацию в «Настройки → Инструменты → Проверка системы» и сверьте требования конкретного обновления в его описании на вкладке списка обновлений. Если требования не выполняются, сначала обновите окружение на хостинге, иначе после установки модуля сайт может перестать открываться с ошибкой.

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

Сделайте резервную копию файлов и базы данных

Резервная копия — единственная гарантия отката, если обновление сломает сайт. Штатный инструмент находится в «Настройки → Инструменты → Резервное копирование»: он упаковывает файлы и базу данных в архив, который можно сохранить локально или в облако Битрикса. Для небольших сайтов этого достаточно.

Для крупных проектов штатный бэкап может работать медленно и упираться в лимиты PHP. В этом случае надёжнее сделать копию средствами сервера: дамп базы через mysqldump и архив файловой структуры через tar. Такой способ быстрее и не зависит от таймаутов веб-сервера.

mysqldump -u user -p database_name > backup.sql && tar -czf site_backup.tar.gz /path/to/site

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

Обновите модуль через систему SiteUpdate

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

Рекомендуемый порядок: сначала обновите модуль «Главный модуль» (main) и систему обновлений, если для них есть новые версии, затем перезагрузите страницу и ставьте остальные модули. Многие модули зависят от версии ядра, и установка «всё сразу» иногда приводит к конфликтам зависимостей. Если обновлений много, ставьте их партиями, проверяя работоспособность сайта после каждой.

1. 1
   Проверьте лицензию и сделайте резервную копию файлов и базы данных
2. 2
   Откройте «Настройки → Обновление платформы» и нажмите «Проверить наличие обновлений»
3. 3
   Прочитайте описания обновлений и требования к окружению
4. 4
   Сначала установите обновления главного модуля и SiteUpdate, затем остальные партиями
5. 5
   После каждой партии откройте сайт и проверьте ключевые страницы
6. 6
   Очистите кеш в «Настройки → Настройки продукта → Автокеширование»

Во время установки не закрывайте вкладку и не обновляйте страницу: прерывание процесса на этапе выполнения SQL-скриптов может оставить базу в промежуточном состоянии. Если страница «зависла», подождите несколько минут — большие пакеты ставятся долго.

Обновите сторонние решения из Marketplace

Модули сторонних разработчиков обновляются отдельно: «Marketplace → Обновление решений». Там отображается список установленных решений с доступными новыми версиями. Перед обновлением откройте страницу решения в каталоге и прочитайте changelog — разработчики указывают совместимость с версиями платформы и возможные изменения в настройках.

Важное отличие от штатных модулей: сторонние решения часто имеют собственные механизмы миграции данных, и их сбой диагностируется сложнее. Если решение критично для бизнеса (обмен с 1С, оплата, доставка), сначала протестируйте обновление на копии сайта. Многие хостинги позволяют развернуть тестовое окружение из бэкапа за несколько минут.

Проверьте результат после обновления

После установки обновлений очистите кеш: «Настройки → Настройки продукта → Автокеширование» → сбросить весь кеш, а также удалите содержимое управляемого кеша, если он используется. Затем пройдите по ключевым сценариям сайта: главная страница, каталог, карточка товара, оформление заказа, личный кабинет, формы обратной связи.

Отдельно проверьте интеграции: обмен с 1С, платёжные шлюзы, службы доставки, почтовые события. Для обмена с 1С запустите тестовую выгрузку и убедитесь, что товары и заказы передаются без ошибок. Просмотрите журнал ошибок PHP и логи Битрикса — там видны проблемы, которые не проявляются визуально.

Откатите обновление при проблемах

Если после обновления сайт сломался, самый надёжный способ — восстановить резервную копию: вернуть файлы из архива и развернуть дамп базы. Штатного механизма «откатить модуль на предыдущую версию» в Битриксе нет, поэтому бэкап перед обновлением — обязательный этап, а не формальность.

Иногда проблема локальна: например, конфликт кеша или устаревший шаблон компонента. В таких случаях помогает полная очистка кеша, проверка кастомных шаблонов в /local/templates/ и сравнение их с обновлёнными стандартными версиями. Если ошибка вызвана конкретным сторонним модулем, временно отключите его в «Marketplace → Установленные решения», чтобы восстановить работу сайта, и обратитесь к разработчику решения.

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