Ошибки модулей
Ошибка 500 после установки модуля OpenCart: что проверить первым
Почему после установки модуля OpenCart появляется 500 ошибка: PHP, OCMOD, права файлов, версия CMS, шаблон, кеш и безопасный план отката.
Ошибка 500 после установки модуля не говорит сама по себе, что модуль плохой. Она означает, что сервер получил критическую ошибку. Нужно увидеть конкретную запись в логах и понять, что именно не совместилось.
Причины
Почему появляется проблема
модуль требует другую версию PHP
Эту причину нужно проверять по логам, настройкам и связанным сценариям магазина, а не только по внешнему виду страницы.
в модуле используется устаревший синтаксис
Эту причину нужно проверять по логам, настройкам и связанным сценариям магазина, а не только по внешнему виду страницы.
OCMOD не нашел нужную строку в шаблоне
Эту причину нужно проверять по логам, настройкам и связанным сценариям магазина, а не только по внешнему виду страницы.
не создалась таблица или не хватает прав
Эту причину нужно проверять по логам, настройкам и связанным сценариям магазина, а не только по внешнему виду страницы.
модуль конфликтует с другим расширением
Эту причину нужно проверять по логам, настройкам и связанным сценариям магазина, а не только по внешнему виду страницы.
Что проверить сначала
Частые ошибки при самостоятельном исправлении
| Ошибка | Почему это опасно |
|---|---|
| удалять файлы модуля вручную без понимания структуры | Можно скрыть симптом, но оставить причину: после следующего заказа, очистки кеша, обновления модуля или обхода робота ошибка вернется. |
| перезаписывать весь сайт из архива | Можно скрыть симптом, но оставить причину: после следующего заказа, очистки кеша, обновления модуля или обхода робота ошибка вернется. |
| оставлять магазин в maintenance без сообщения клиентам | Можно скрыть симптом, но оставить причину: после следующего заказа, очистки кеша, обновления модуля или обхода робота ошибка вернется. |
| не проверять таблицы и настройки после отката | Можно скрыть симптом, но оставить причину: после следующего заказа, очистки кеша, обновления модуля или обхода робота ошибка вернется. |
Безопасный порядок действий
Сначала зафиксируйте симптом и время ошибки, затем сделайте резервную копию или тестовую копию, проверьте логи и только после этого меняйте настройки, модификаторы или код. После исправления важно пройти связанные сценарии: каталог, карточку товара, корзину, оплату, письма, мобильную версию и страницы, которые уже попали в Яндекс.
Частые вопросы
Почему 500 ошибка видна только в админке?
Модуль может падать только на странице настроек, списка заказов или обновления модификаторов. Поэтому важно проверять точный URL.
Можно ли вернуть сайт без удаления модуля?
Часто да: временно отключается модификатор, событие или проблемный файл, а затем модуль дорабатывается.
Что прислать разработчику?
Ссылку, время ошибки, лог, версию OpenCart/ocStore, PHP и название установленного модуля.
Нужна диагностика OpenCart?
Пришлите ссылку на магазин, описание симптома и скриншот или текст ошибки. Я посмотрю, где может быть причина, и предложу безопасный порядок исправления.
Перейти к диагностике