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

Администрирование · 10 мин

Как удалить решение 1С-Битрикс без последствий для сайта

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

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

Под «решением» в Битрикс обычно понимают модуль из Маркетплейса, готовый сайт-шаблон (решение с мастером установки) или собственный модуль разработчика. Порядок удаления у них немного отличается, но общий принцип один: сначала штатная деинсталляция через административный раздел, затем при необходимости ручная зачистка остатков.

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

Что проверить перед удалением решения

Сначала выясните, что именно вы удаляете. Откройте раздел «Настройки → Настройки продукта → Модули» и найдите решение в списке. Обратите внимание на идентификатор модуля (например, partner.shop) — он понадобится для поиска остаточных файлов и таблиц.

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

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

Модуль виден в списке модулейШтатная ситуация

Удаляйте стандартно через кнопку «Удалить» в списке модулей

Папки модуля есть, в списке его нетОстатки после некорректного удаления

Потребуется ручная чистка файлов и таблиц

На сайте используются компоненты модуляРиск поломки страниц

Найдите и уберите вызовы компонентов до деинсталляции

Модуль создавал инфоблоки и свойстваДанные будут потеряны

Экспортируйте нужные данные до удаления

Резервная копия — обязательный шаг

Создайте резервную копию штатными средствами: «Настройки → Инструменты → Резервное копирование». Включите в копию и базу данных, и файлы. Для больших сайтов удобнее делать копию через хостинг-панель или вручную: дамп базы через mysqldump и архив корневой директории сайта.

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

Штатное удаление модуля через административный раздел

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

На шаге удаления система обычно предлагает опции: удалить таблицы и данные модуля, удалить настройки. Если решение больше не понадобится — отмечайте удаление данных. Если удаляете модуль временно (например, для переустановки), данные можно сохранить.

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

Порядок действий
  1. 1
    Сделайте полную резервную копию файлов и базы данных
  2. 2
    Найдите и отключите компоненты модуля на страницах и в шаблоне
  3. 3
    Откройте Настройки → Настройки продукта → Модули
  4. 4
    В меню модуля выберите «Удалить» и отметьте удаление данных
  5. 5
    Проверьте раздел Marketplace → Установленные решения и удалите решение оттуда
  6. 6
    Удалите остаточные папки модуля из /bitrix/modules/ и /local/modules/
  7. 7
    Проверьте работоспособность сайта и очистите кеш

Удаление решения-шаблона (готового сайта)

Решения с мастером установки (типовые интернет-магазины, корпоративные сайты) состоят из модуля и шаблона сайта. Модуль удаляется описанным выше способом, а шаблон — отдельно: «Настройки → Настройки продукта → Сайты → Шаблоны» или через «Внешний вид → Шаблоны сайта» в зависимости от версии.

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

Демо-данные (инфоблоки каталога, разделы, страницы), созданные мастером установки, при удалении модуля обычно не стираются автоматически. Их придётся удалить вручную через соответствующие разделы админки: инфоблоки, структуру сайта, меню.

Ручная зачистка остатков после деинсталляции

После штатного удаления на диске могут остаться папки и файлы модуля. Проверьте директории /bitrix/modules/ и /local/modules/ — если папка с идентификатором решения осталась, удалите её. Также поищите следы в /bitrix/components/, /local/components/, /bitrix/templates/ и /local/templates/.

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

Дополнительно проверьте агенты (Настройки → Инструменты → Агенты) и почтовые события — модули часто регистрируют свои агенты и шаблоны писем, которые после удаления будут вызывать ошибки в логах.

bash
# Поиск остатков модуля по идентификатору (пример: partner.shop)
find /path/to/site -type d -name "<em>partner.shop</em>"
# Поиск таблиц модуля в базе
mysql -u user -p dbname -e "SHOW TABLES LIKE '%partner_shop%';"

Типичные ошибки и риски при удалении

Самая частая ошибка — удаление папки модуля по FTP без штатной деинсталляции. Платформа продолжает считать модуль установленным, подключает его в init.php и настройках, и сайт падает с ошибкой. Восстановление в этом случае — возврат папки из бэкапа и правильное удаление через админку.

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

Типичные ошибки
01
Удаление папки модуля по FTP вместо деинсталляции — сайт перестаёт работать из-за вызовов несуществующих классов
02
Удаление без резервной копии — потерянные таблицы и данные восстановить не из чего
03
Не отключены компоненты модуля в шаблоне — на страницах появляются ошибки после удаления
04
Оставлены агенты модуля — логи заполняются ошибками, крон выполняет несуществующие функции
05
Удалён модуль, от которого зависят другие решения — ломаются связанные функции сайта

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

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

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

Контрольные точки

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

Список модулей в админке
Норма

Удалённого модуля нет в перечне

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

Модуль отображается или числится с ошибкой

Страницы сайта
Норма

Все разделы открываются без ошибок

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

Ошибки вида «модуль не найден» или пустые блоки

Логи PHP и журнал событий
Норма

Нет записей про удалённый модуль

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

Повторяющиеся ошибки с идентификатором модуля

Файловая система и база
Норма

Папок и таблиц модуля нет

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

Остались папки в modules или таблицы с префиксом модуля

Итог

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

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

Частые вопросы об удалении решений Битрикс

Можно ли удалить решение, если лицензия Маркетплейса истекла?

Да, истечение лицензии не блокирует деинсталляцию модуля. Кнопка «Удалить» в списке модулей остаётся доступной. Ограничения касаются только обновлений и повторной установки решения из Маркетплейса.

Что делать, если после удаления модуля сайт показывает белый экран?

Скорее всего, в шаблоне или init.php остались вызовы классов удалённого модуля. Включите отображение ошибок или посмотрите лог PHP, найдите файл и строку с вызовом и уберите её. Если причина неясна — восстановите сайт из резервной копии и повторите удаление корректно.

Удаляются ли данные инфоблоков вместе с модулем?

Как правило, нет. Инфоблоки, созданные решением, остаются в системе после деинсталляции и удаляются вручную через раздел «Инфоблоки». Исключение — модули, чей деинсталлятор явно предлагает удалить связанные инфоблоки; внимательно читайте опции на шаге удаления.

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

Это следы некорректного удаления. Проверьте, что никакой код сайта не подключает классы модуля, затем вручную удалите папки из /bitrix/modules/ и /local/modules/, найдите и удалите его таблицы в базе, агенты и почтовые шаблоны. Перед этим сделайте резервную копию.

Можно ли временно отключить модуль, не удаляя его?

Штатного переключателя «включить/выключить» у модулей Битрикс нет. Варианты — убрать подключение модуля в настройках или закомментировать его вызовы в коде, но корректный способ «заморозки» — деинсталляция с сохранением данных и повторная установка позже, если решение это поддерживает.

Опасно ли удалять стандартные модули Битрикс?

Да. Системные модули (main, iblock, sale и другие ядровые) удалять нельзя — от них зависит работа платформы. Удалять следует только сторонние решения из Маркетплейса и собственные модули, в назначении которых вы уверены.