Администрирование · 10 мин
Как удалить решение 1С-Битрикс без последствий для сайта
Как правильно удалить решение 1С-Битрикс: деинсталляция модуля через админку, очистка файлов и базы данных, типичные ошибки и проверка результата.
Удаление решения в 1С-Битрикс — операция, которая затрагивает не только файлы модуля, но и таблицы базы данных, настройки, агенты и привязанные компоненты. Если просто стереть папку модуля с сервера, сайт может перестать открываться: страницы будут ссылаться на несуществующие классы, а в логах появятся фатальные ошибки PHP. Поэтому удалять решение нужно строго через штатный механизм платформы.
Под «решением» в Битрикс обычно понимают модуль из Маркетплейса, готовый сайт-шаблон (решение с мастером установки) или собственный модуль разработчика. Порядок удаления у них немного отличается, но общий принцип один: сначала штатная деинсталляция через административный раздел, затем при необходимости ручная зачистка остатков.
Перед любыми действиями сделайте полную резервную копию сайта — файлов и базы данных. Это единственная гарантия, что при ошибке вы вернёте рабочее состояние за минуты, а не будете восстанавливать данные вручную.
Что проверить перед удалением решения
Сначала выясните, что именно вы удаляете. Откройте раздел «Настройки → Настройки продукта → Модули» и найдите решение в списке. Обратите внимание на идентификатор модуля (например, partner.shop) — он понадобится для поиска остаточных файлов и таблиц.
Проверьте зависимости. Некоторые модули требуются другими решениями: если от удаляемого модуля зависят компоненты шаблона или другие модули, после деинсталляции они начнут выдавать ошибки. Поищите идентификатор модуля в файлах шаблона сайта и в настройках компонентов на страницах.
Оцените, какие данные хранит решение. Модули интернет-магазинов, форм, CRM-интеграций часто создают собственные таблицы, инфоблоки, свойства и почтовые шаблоны. При удалении с очисткой данных эта информация будет потеряна безвозвратно.
Удаляйте стандартно через кнопку «Удалить» в списке модулей
Потребуется ручная чистка файлов и таблиц
Найдите и уберите вызовы компонентов до деинсталляции
Экспортируйте нужные данные до удаления
Резервная копия — обязательный шаг
Создайте резервную копию штатными средствами: «Настройки → Инструменты → Резервное копирование». Включите в копию и базу данных, и файлы. Для больших сайтов удобнее делать копию через хостинг-панель или вручную: дамп базы через mysqldump и архив корневой директории сайта.
Проверьте, что копия реально создана и скачивается. Нередко администраторы запускают резервное копирование, но не дожидаются завершения — а потом обнаруживают битый архив именно в момент, когда он нужен.
Штатное удаление модуля через административный раздел
Основной способ удаления — через список модулей. Перейдите в «Настройки → Настройки продукта → Модули», найдите нужное решение и в меню действий выберите «Удалить». Платформа запустит деинсталлятор модуля.
На шаге удаления система обычно предлагает опции: удалить таблицы и данные модуля, удалить настройки. Если решение больше не понадобится — отмечайте удаление данных. Если удаляете модуль временно (например, для переустановки), данные можно сохранить.
После завершения деинсталляции модуль исчезнет из списка установленных. Для решений из Маркетплейса может дополнительно потребоваться удаление в разделе «Marketplace → Установленные решения» — там решение удаляется из перечня загруженных.
- 1Сделайте полную резервную копию файлов и базы данных
- 2Найдите и отключите компоненты модуля на страницах и в шаблоне
- 3Откройте Настройки → Настройки продукта → Модули
- 4В меню модуля выберите «Удалить» и отметьте удаление данных
- 5Проверьте раздел Marketplace → Установленные решения и удалите решение оттуда
- 6Удалите остаточные папки модуля из /bitrix/modules/ и /local/modules/
- 7Проверьте работоспособность сайта и очистите кеш
Удаление решения-шаблона (готового сайта)
Решения с мастером установки (типовые интернет-магазины, корпоративные сайты) состоят из модуля и шаблона сайта. Модуль удаляется описанным выше способом, а шаблон — отдельно: «Настройки → Настройки продукта → Сайты → Шаблоны» или через «Внешний вид → Шаблоны сайта» в зависимости от версии.
Учтите важный момент: шаблон решения часто копируется в папку сайта и модифицируется под проект. Если вы удаляете решение, но шаблон остаётся назначенным сайту, страницы начнут ссылаться на удалённые компоненты модуля. Сначала переключите сайт на другой шаблон и только потом удаляйте модуль и файлы решения.
Демо-данные (инфоблоки каталога, разделы, страницы), созданные мастером установки, при удалении модуля обычно не стираются автоматически. Их придётся удалить вручную через соответствующие разделы админки: инфоблоки, структуру сайта, меню.
Ручная зачистка остатков после деинсталляции
После штатного удаления на диске могут остаться папки и файлы модуля. Проверьте директории /bitrix/modules/ и /local/modules/ — если папка с идентификатором решения осталась, удалите её. Также поищите следы в /bitrix/components/, /local/components/, /bitrix/templates/ и /local/templates/.
В базе данных могут остаться таблицы с префиксом модуля. Просмотреть их можно через phpMyAdmin или консоль MySQL. Удаляйте только те таблицы, в принадлежности которых к модулю вы полностью уверены.
Дополнительно проверьте агенты (Настройки → Инструменты → Агенты) и почтовые события — модули часто регистрируют свои агенты и шаблоны писем, которые после удаления будут вызывать ошибки в логах.
# Поиск остатков модуля по идентификатору (пример: 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 и настройках, и сайт падает с ошибкой. Восстановление в этом случае — возврат папки из бэкапа и правильное удаление через админку.
Вторая ошибка — удаление с очисткой данных без проверки зависимостей. Если модуль хранил, например, привязки заказов или результаты форм, эти данные исчезнут вместе с таблицами. Третья типичная ситуация — забытые вызовы компонентов модуля в шаблоне: после удаления на страницах появляются сообщения об ошибках вместо контента.
Проверка результата после удаления
После завершения всех действий сбросьте кеш: «Настройки → Настройки продукта → Автокеширование» или кнопка очистки кеша на панели управления. Пройдитесь по основным разделам сайта — главной, каталогу, страницам с формами — и убедитесь, что всё открывается без ошибок.
Проверьте журнал событий и логи PHP на предмет упоминаний удалённого модуля. Убедитесь, что в списке модулей решения нет, папки удалены с диска, а в базе не осталось его таблиц. Если всё чисто и сайт работает стабильно в течение хотя бы суток — удаление можно считать завершённым.
Как проверить результат
Удалённого модуля нет в перечне
Модуль отображается или числится с ошибкой
Все разделы открываются без ошибок
Ошибки вида «модуль не найден» или пустые блоки
Нет записей про удалённый модуль
Повторяющиеся ошибки с идентификатором модуля
Папок и таблиц модуля нет
Остались папки в modules или таблицы с префиксом модуля
Что важно запомнить
Удаляйте решение только через штатную деинсталляцию в списке модулей, обязательно с предварительной резервной копией. После удаления зачистите остатки: папки, таблицы, агенты и вызовы компонентов в шаблоне — и проверьте работу сайта по логам.
Частые вопросы об удалении решений Битрикс
Можно ли удалить решение, если лицензия Маркетплейса истекла?
Да, истечение лицензии не блокирует деинсталляцию модуля. Кнопка «Удалить» в списке модулей остаётся доступной. Ограничения касаются только обновлений и повторной установки решения из Маркетплейса.
Что делать, если после удаления модуля сайт показывает белый экран?
Скорее всего, в шаблоне или init.php остались вызовы классов удалённого модуля. Включите отображение ошибок или посмотрите лог PHP, найдите файл и строку с вызовом и уберите её. Если причина неясна — восстановите сайт из резервной копии и повторите удаление корректно.
Удаляются ли данные инфоблоков вместе с модулем?
Как правило, нет. Инфоблоки, созданные решением, остаются в системе после деинсталляции и удаляются вручную через раздел «Инфоблоки». Исключение — модули, чей деинсталлятор явно предлагает удалить связанные инфоблоки; внимательно читайте опции на шаге удаления.
Как удалить модуль, если в списке модулей его нет, а папки на сервере остались?
Это следы некорректного удаления. Проверьте, что никакой код сайта не подключает классы модуля, затем вручную удалите папки из /bitrix/modules/ и /local/modules/, найдите и удалите его таблицы в базе, агенты и почтовые шаблоны. Перед этим сделайте резервную копию.
Можно ли временно отключить модуль, не удаляя его?
Штатного переключателя «включить/выключить» у модулей Битрикс нет. Варианты — убрать подключение модуля в настройках или закомментировать его вызовы в коде, но корректный способ «заморозки» — деинсталляция с сохранением данных и повторная установка позже, если решение это поддерживает.
Опасно ли удалять стандартные модули Битрикс?
Да. Системные модули (main, iblock, sale и другие ядровые) удалять нельзя — от них зависит работа платформы. Удалять следует только сторонние решения из Маркетплейса и собственные модули, в назначении которых вы уверены.