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