Удаление и переустановка
При удалении модуля можно оставить настройки в базе данных или удалить их вместе с таблицами. Ниже описаны последствия обоих вариантов и поведение повторной установки.
Если вы хотите перейти на новую версию, используйте штатное обновление. Удаление для этого не требуется.
Подготовка
- Создайте согласованную резервную копию файлов и БД и проверьте способ восстановления.
- Найдите шаблоны и скрипты, использующие
Settings. - Предусмотрите поведение при
Loader::includeModule('kokhanenko.settings') === false. Без проверки подключения обращение к классу может вызвать ошибку. - На рабочем сайте запланируйте окно обслуживания. Удаление и восстановление сначала проверьте на изолированной копии.
Выбор при удалении
Запустите штатное удаление решения в админке Битрикса. Установщик предлагает флажок сохранения данных. Перед подтверждением проверьте его состояние.
| Вариант | Что происходит |
|---|---|
| Сохранить данные | Таблицы и значения остаются в БД; модуль снимается с регистрации, административные файлы и обработчик меню удаляются |
| Не сохранять данные | Удаляются таблицы b_kokhanenko_settings и b_kokhanenko_settings_types, а также опции модуля; модуль снимается с регистрации, административные файлы и обработчик меню удаляются |
warning
В обоих случаях модуль перестаёт работать. Даже если данные сохранены, читать их через Settings до повторной установки нельзя. Сохранение таблиц не заменяет резервную копию.
Чтобы удалить только одно поле или раздел, не удаляйте весь модуль. Используйте действия в административной панели.
Повторная установка 2.0.0
Данные были сохранены
При повторной установке поверх сохранённой конечной схемы 2.0.0 установщик использует существующие таблицы. Если обе таблицы присутствуют, установочные примеры не создаются заново и значения не должны заменяться примерами.
После установки проверьте регистрацию модуля, разделы, сайт, чтение API и сохранение обратимого тестового значения. Файлы модуля должны соответствовать версии схемы.
Данные были удалены
Повторная установка создаст новые таблицы и установочные примеры для доступных сайтов.
warning
Прежние настройки и их значения при этом не восстанавливаются. Вернуть их можно только из резервной копии.
Остались таблицы 1.1.3 или неполный набор таблиц
Таблицы 1.1.3 должны пройти перенос данных при обновлении. Повторная установка 2.0.0 не заменяет этот процесс.
Если часть таблиц отсутствует или их состояние неизвестно, не продолжайте установку на рабочем сайте. Сначала выясните причину на тестовой копии либо восстановите файлы и БД из одной резервной копии.
Восстановление
Восстанавливайте совместимый набор файлов и БД. Для возврата к 1.1.3 нужна пара «файлы 1.1.3 + база 1.1.3», а не только старые PHP-файлы. Если менялись шаблоны, верните подходящую версию интеграции и очистите кеши проекта.
Не удаляйте неожиданный bd/database.sqlite без выяснения происхождения и резервной копии: активное хранилище 2.0.0 — БД Битрикса, но файл может содержать исторические данные.