Как полностью удалить модуль в OpenCart и не сломать магазин

После удаления модуля в OpenCart 3 и ocStore 3 на сайте почти всегда остаются модификации, события, настройки и таблицы. Иногда магазин после этого ломается. Разбираем, что именно делают обе кнопки «Удалить», как удалять модуль по шагам и как чинить типичные ошибки.
Как полностью удалить модуль в OpenCart и не сломать магазин

На форумах по OpenCart одна и та же история повторяется годами. Владелец удаляет ненужный модуль, а потом видит белый экран, ошибку 500 или сообщение «Could not load model» про расширение, которого на сайте уже нет. Бывает и наоборот: всё работает, но в базе копятся таблицы, события и настройки давно удалённых дополнений, а модуль не ставится повторно, потому что его таблица «уже существует». Причина в том, как OpenCart 3 устанавливает и удаляет расширения. Ниже разбираем механику по исходному коду движка, правильный порядок удаления и способы починить магазин, если удаление уже пошло не так. Всё сказанное относится к OpenCart 3.0.x и ocStore 3.0.x.

Где модуль OpenCart 3 оставляет следы

Модуль в OpenCart 3 — это набор файлов и записей в базе, разбросанных по разным местам. Единого списка «всё, что поставил модуль» движок не ведёт. Полная установка обычно затрагивает:

  • Файлы. Контроллеры, модели, языковые файлы и шаблоны в папках admin и catalog, иногда библиотеки в system/library и картинки в image.
  • Модификации OCMOD. Правки чужих файлов движка хранятся в таблице oc_modification, а готовые изменённые копии файлов лежат в кэше system/storage/modification.
  • События. Обработчики в таблице oc_event, которые движок вызывает при открытии страниц, оформлении заказа и других действиях.
  • Регистрация и настройки. Запись в oc_extension, настройки в oc_setting с кодом вида module_имя, экземпляры модуля в oc_module и его позиции в схемах в oc_layout_module.
  • Права доступа. Маршруты модуля в правах групп пользователей.
  • Собственные таблицы. Многие модули создают свои таблицы для данных, логов и настроек.
  • Записи установщика. Если модуль ставили через «Установку расширений», в таблицах oc_extension_install и oc_extension_path хранится список его файлов.

Если модуль залили по FTP, записей установщика у него нет вовсе. Движок не знает, какие файлы ему принадлежат.

Две кнопки «Удалить» в OpenCart 3 делают разное

В админке OpenCart 3 удалить модуль можно в двух местах, и большинство проблем начинается с того, что их путают.

Кнопка в разделе «Расширения → Модули» снимает модуль с регистрации. Она удаляет запись в oc_extension, настройки модуля в oc_setting, все его экземпляры и позиции в схемах, а затем вызывает метод uninstall() самого модуля. Что сделает этот метод, решает разработчик. Аккуратный модуль удалит свои события и таблицы, небрежный не удалит ничего. В OpenCart 3.0.4.0 и новее эта кнопка ещё и убирает права доступа к модулю из групп пользователей, в более ранних версиях права остаются. Файлы модуля эта кнопка не трогает.

Кнопка в истории «Расширения → Установка расширений» работает с файлами. Она берёт список путей, который установщик записал при загрузке архива, удаляет эти файлы, стирает запись установки и модификации OCMOD, пришедшие с этим архивом. Метод uninstall() модуля она не вызывает, кэш модификаторов не обновляет и в настройки, события и таблицы не заглядывает.

Есть и третья кнопка, в разделе «Модификаторы». Она удаляет только запись модификации OCMOD, файлы модуля остаются на месте.

Чем опасна кнопка в истории установщика OpenCart 3

Установщик OpenCart 3 записывает в список пакета каждый файл, который скопировал из архива, и не проверяет, лежал ли такой файл на сайте раньше. Отсюда три риска, которые регулярно всплывают на форумах.

  • Удаление файлов движка. Если модуль при установке перезаписал стандартный файл, установщик считает этот файл частью модуля. При удалении он сотрёт его, и магазин останется без нужного контроллера или библиотеки.
  • Удаление чужих папок. В OpenCart до версии 3.0.3.7 включительно и в сборках ocStore на их основе папка, которую первым создал модуль, удаляется при деинсталляции целиком, вместе с файлами других модулей. С версии 3.0.3.8 установщик удаляет только опустевшие папки.
  • Сломанный кэш модификаций. Модификации пакета стираются из базы, но изменённые копии файлов в system/storage/modification остаются до ручного обновления модификаторов. Пока кэш не обновлён, сайт выполняет код, который ссылается на удалённые классы, и падает с ошибкой вида «Class not found».

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

Правильный порядок удаления модуля в OpenCart 3

Безопасная последовательность для OpenCart 3 и ocStore 3 выглядит так.

  1. Резервная копия. Сохраните файлы сайта и дамп базы данных. Если есть возможность, сначала проверьте удаление на копии магазина на поддомене.
  2. Проверка зависимостей. Убедитесь, что от модуля не зависят другие дополнения или тема. Некоторые разработчики выносят общий код в отдельный модуль-библиотеку, и его удаление ломает остальные их расширения.
  3. Штатная деинсталляция. В «Расширения → Расширения» выберите тип расширения (модули, оплата, доставка и т. д.) и нажмите красную кнопку удаления у нужного модуля. Так отработает его собственный uninstall(), пока файлы ещё на месте.
  4. Удаление файлов. В «Расширения → Установка расширений» удалите запись модуля в истории. Если записей несколько, например после обновлений, удалите все версии.
  5. Обновление модификаторов. В «Расширения → Модификаторы» нажмите кнопку «Обновить». Кэш модификаций пересоберётся без удалённых правок.
  6. Очистка кэша шаблонов. На главной странице админки откройте настройки разработчика (значок шестерёнки) и обновите кэш шаблонов. Если на сайте стоят модули ускорения или серверное кэширование, очистите и их кэш.
  7. Проверка. Откройте витрину, карточку товара, корзину и оформление заказа, затем загляните в «Система → Обслуживание → Журнал ошибок» и во вкладку «Лог» в модификаторах.

Если модуль перезаписывал стандартные файлы движка, перед шагом 4 сравните список файлов пакета с дистрибутивом своей версии OpenCart. Такие файлы нельзя удалять, их нужно вернуть из оригинального архива движка.

Как удалить модуль OpenCart 3, установленный по FTP или без архива

Модуль, загруженный в OpenCart 3 по FTP, в истории установщика не появляется, и кнопка удаления файлов для него недоступна. Удалять его приходится вручную.

  • Код модуля. Откройте настройки модуля в админке и посмотрите адрес страницы. Часть после route=extension/module/ и есть код, по которому называются его файлы.
  • Файлы по коду. Найдите файлы с этим именем в admin/controller, admin/model, admin/language, admin/view и в таких же папках catalog. Если есть доступ к консоли сервера, удобна команда grep -rl "код_модуля" . из корня сайта.
  • Модификации в файлах. Модули, залитые по FTP, часто кладут файл *.ocmod.xml прямо в папку system. В базе такой модификации нет, и раздел «Модификаторы» её не показывает. Файл нужно удалить, затем обновить модификаторы.
  • vQmod. Если на сайте стоит vQmod, проверьте папку vqmod/xml и очистите vqmod/vqcache. На форумах хватает случаев, когда хвост удалённого модуля жил именно там.
  • Общие имена. Будьте осторожны с файлами, у которых простые имена вроде google.php или filter.php. Такие имена встречаются у разных модулей и у самого движка.

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

Ошибки после удаления модуля и как их исправить

Большинство поломок после удаления модуля в OpenCart 3 сводится к нескольким типовым сообщениям. По тексту ошибки обычно понятно, где искать хвост.

  • «Class… not found in .../storage/modification/...». В кэше модификаций осталась изменённая копия файла, которая вызывает код удалённого модуля. Обновите модификаторы. Если админка не открывается, очистите содержимое папки system/storage/modification по FTP, движок пересоберёт её при следующем обновлении. Если хранилище перенесено, путь к нему указан в константе DIR_MODIFICATION или DIR_STORAGE в файле config.php.
  • «Error: Could not load model» или «Could not load controller». Движок пытается вызвать модуль, файлов которого нет. Чаще всего виновато событие в oc_event или позиция модуля в схеме. Найдите в таблице oc_event записи, в поле action которых упоминается код модуля, и удалите их. Позиции в схемах проверьте в oc_layout_module.
  • «Table… already exists» при повторной установке. Прошлая установка оставила таблицу в базе. Удалите её в phpMyAdmin, если данные в ней не нужны, и установите модуль заново.
  • Белый экран в разделе «Модификаторы». Обычно мешает устаревший кэш шаблонов или модификация, которая ссылается на удалённый код. Обновите кэш шаблонов, затем модификаторы, и загляните в журнал ошибок PHP.
  • Правка в storage/modification пропадает. Файлы в кэше модификаций перезаписываются при каждом обновлении модификаторов. Исправлять нужно исходную модификацию или файл движка, кэш править бесполезно.
  • «Доступ запрещён» после удаления. Если права группы администраторов слетели целиком, проверьте параметр max_input_vars в настройках PHP. При большом числе модулей форма прав может сохраняться не полностью. Права можно вернуть в «Система → Пользователи → Группы пользователей».

Перед ручной правкой базы обязательно сделайте дамп. Префикс таблиц на вашем сайте может отличаться от oc_, он указан в config.php в константе DB_PREFIX.

Как найти хвосты удалённых модулей в базе OpenCart 3

Даже если магазин работает без ошибок, в базе старого сайта на OpenCart 3 обычно накапливается мусор от модулей, которые ставили и удаляли годами. Проверить основные места можно несколькими запросами в phpMyAdmin. В примерах ниже код_модуля нужно заменить на код конкретного расширения.

SELECT * FROM oc_event WHERE action LIKE '%код_модуля%';
SELECT * FROM oc_setting WHERE code LIKE '%код_модуля%';
SELECT * FROM oc_layout_module WHERE code LIKE '%код_модуля%';
SELECT * FROM oc_modification WHERE code LIKE '%код_модуля%';
SHOW TABLES LIKE '%код_модуля%';

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

Отдельная история — сайты после переезда на другой хостинг. Некоторые модули сохраняют в настройках абсолютные пути к файлам, например к логам или папке выгрузки. На новом сервере таких путей нет, и модуль начинает сыпать ошибками вида «failed to open stream». Проверьте настройки модулей и пути в обоих файлах config.php, в корне и в папке admin.

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

Деинсталлятор Pro для OpenCart 3 и ocStore 3

Чтобы не проходить всё это вручную, мы сделали модуль Деинсталлятор Pro. Он выполняет описанную выше последовательность за один проход и закрывает риски штатного установщика OpenCart 3.

  • Предпросмотр. Перед удалением модуль показывает каждый файл, папку, модификацию, событие и запись установщика с пометкой, удалится она или останется, и с причиной. До подтверждения магазин не меняется.
  • Защита движка и чужих файлов. Деинсталлятор сверяется со списком стандартных файлов OpenCart и ocStore 3.x и не удаляет их, даже если модуль их перезаписал. Файлы других пакетов остаются на месте, папки удаляются только опустевшими.
  • Правильный порядок. Сначала сохраняется архив для отката, затем вызывается штатный uninstall() модуля, удаляются файлы, модификации и события, а модификаторы обновляются автоматически.
  • Модули без установщика. Модификации из файлов system/*.ocmod.xml удаляются так же, как из базы, а модули, залитые по FTP, находятся по установочному архиву.
  • Сборка архива. Если исходного архива нет, Деинсталлятор Pro соберёт обычный .ocmod.zip из файлов модуля на сервере и его модификаций. Файлы движка в архив не попадают.
  • Диагностика. Отдельный режим только показывает проблемы и ничего не меняет без вашего действия. Он находит события без обработчиков, расширения без файлов, пустые позиции в схемах, неприменившиеся модификации, пути старого сервера и таблицы, на которые не ссылается ни один модуль.
  • Изображения. Поиск неиспользуемых картинок и пустых папок с архивом перед удалением, а также список товаров, категорий и баннеров со ссылками на отсутствующие файлы.

Деинсталлятор Pro работает на OpenCart 3.0.x и ocStore 3.0.x с PHP от 7.4 до 8.4 и требует расширения ZipArchive. Модуль не меняет файлы движка и не создаёт своих таблиц. Таблицы удаляемых модулей он не трогает, это задача их собственной деинсталляции, а оставшиеся таблицы показывает в диагностике. Перезаписанные файлы движка модуль сохраняет на месте, но не восстанавливает, оригинал нужно взять из дистрибутива вашей версии.

Частые вопросы
Как правильно удалить модуль в OpenCart 3, чтобы не осталось хвостов?

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

Чем отличается удаление в «Модификаторах» от удаления в «Установке расширений»?

Кнопка в «Модификаторах» удаляет только модификацию OCMOD, файлы модуля остаются. Кнопка в истории «Установки расширений» удаляет файлы, записанные установщиком, и модификации из того же архива, но не трогает настройки, события и таблицы.

Почему после удаления модуля сайт выдаёт белый экран или ошибку 500?

Чаще всего в кэше модификаций остались изменённые копии файлов, которые обращаются к удалённому коду. Обновите модификаторы в админке, а если она недоступна, очистите папку system/storage/modification по FTP.

Как обновить модификаторы, если админка не открывается?

Удалите содержимое папки system/storage/modification по FTP или через файловый менеджер хостинга. Если хранилище перенесено, путь к нему указан в config.php. После входа в админку нажмите «Обновить» в разделе «Модификаторы».

Откуда ошибка «Could not load model», если модуля уже нет?

Движок вызывает модуль по оставшемуся событию в таблице oc_event или по позиции модуля в схеме. Удалите событие с кодом модуля и проверьте позиции в «Дизайн → Схемы».

Модуль не устанавливается повторно, пишет «Table already exists». Что делать?

Таблица осталась от прошлой установки. Если данные в ней не нужны, удалите её в phpMyAdmin и установите модуль заново.

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

Узнайте код модуля из адреса его настроек, найдите файлы с этим именем в папках admin и catalog, удалите файл *.ocmod.xml из папки system, если он есть, и обновите модификаторы. Если на сайте стоит vQmod, проверьте папку vqmod/xml.

Почему после удаления одного модуля перестали работать другие?

OpenCart до версии 3.0.3.7 штатный установщик удаляет папку, созданную модулем, целиком, вместе с файлами других дополнений. Кроме того, если модуль перезаписал стандартный файл движка, установщик удалит и его.

Удаляет ли OpenCart таблицы модуля при деинсталляции?

Только если это предусмотрел разработчик в методе uninstall() модуля. Сам движок таблицы модулей не удаляет и не ведёт их список.

71
Нет комментариев. Ваш будет первым!
Посещая этот сайт, вы соглашаетесь с тем, что мы используем файлы cookie.