Белый экран в OpenCart: причины и пошаговое решение

Краткое описание задачи

Из практики. Клиент обновил модуль доставки — и сайт погас: белый экран на всех страницах. Паника, звонок в 23:00. Заходим в лог ошибок PHP (/var/log/php_error.log на хостинге) — видим: «Fatal error: Cannot redeclare class ModelExtensionShippingCustom». Дублирование класса: новый модуль определял тот же класс, что и старый, который не удалили перед обновлением. Нашли файл старого модуля в /admin/model/extension/shipping/, удалили — сайт заработал. Типичная ситуация: при обновлении модуля старые файлы остаются, PHP пытается загрузить два класса с одним именем и падает. Решение перед каждым обновлением — удалить старую версию модуля полностью (через админку или вручную проверить файлы) и только потом заливать новую.

Как не надо. Не пытайтесь «починить» белый экран случайными правками — менять файлы наугад, перезаливать ядро OpenCart поверх существующего, удалять непонятные файлы. Порядок действий: 1) включите display_errors в PHP (временно, через .htaccess или php.ini) — белый экран превратится в сообщение об ошибке; 2) проверьте error_log на сервере — там будет точная причина; 3) если лога нет — создайте файл error_log в корне сайта и дайте права 666; 4) восстановите из бэкапа, если не удаётся найти причину за 15 минут. И обязательно — сделайте бэкап перед тем, как править что-либо, даже если кажется, что «я просто смотрю».

Белый экран (White Screen of Death) — одна из самых пугающих ошибок OpenCart. Сайт открывается, но вместо контента — пустая страница. По практике, чаще всего это связано с ошибкой PHP, которая скрыта настройками сервера.

Почему это происходит

• Фатальная ошибка PHP при вызове неправильного кода в модуле или шаблоне
• Нехватка памяти (memory limit) — особенно на страницах с большим каталогом
• Конфликт модулей — два модуля пытаются переопределить один и тот же метод
• Ошибка синтаксиса в файлах OpenCart или модулей

Как найти причину

Шаг 1. Включите отображение ошибок

Добавьте в index.php в корне OpenCart:

ini_set("display_errors", 1); error_reporting(E_ALL);

Шаг 2. Посмотрите логи

Откройте system/storage/logs/error.log — там будет конкретная ошибка с номером строки и файлом.

Шаг 3. Проверьте логи сервера

Если в логах OpenCart пусто — смотрите логи сервера: /var/log/apache2/error.log или /var/log/nginx/error.log.

Рекомендации из практики

Как лучше: Включите отображение ошибок через админку или .htaccess: php_flag display_errors on. Белый экран — это невидимая ошибка PHP.

Как не делать: Не начинайте с перезагрузки сервера. Белый экран — это всегда ошибка в коде, а не проблема сервера.

Кейс из практики: Белый экран на странице категории. Включили отображение ошибок — увидели «Call to undefined function в модуле фильтра». Отключили модуль — страница заработала. Заменили фильтр на другой.

По практике, белый экран в OpenCart всегда лечится включением отображения ошибок. Нужна помощь — закажите техподдержку

Как исправить

Если ошибка в модуле

Временно переименуйте папку модуля в system/storage/modification/ и очистите кэш модификаторов. Если белый экран исчез — проблема в этом модуле.

Если не хватает памяти

Увеличьте лимит: добавьте в .htaccess строку php_value memory_limit 256M или обратитесь к хостинг-провайдеру.

Если ошибка в шаблоне

Включите стандартный шаблон OpenCart (Journal, UniShop → default). Если заработало — проблема в кастомизации шаблона.

FAQ

Белый экран появляется только в админке. Почему?

Чаще всего из-за модуля, который грузится только в админке. Переименуйте папки модулей по очереди, чтобы найти проблемный.

Как предотвратить белый экран?

Тестируйте модули и обновления на копии сайта перед установкой на продакшен.

Белый экран после обновления ядра OpenCart. Что делать?

Вернитесь на предыдущую версию из бэкапа и проверьте совместимость модулей с новой версией. По практике, 40% белых экранов после обновления ядра вызваны модулями, которые не были обновлены.

Можно ли восстановить сайт без бэкапа?

Технически да, но это занимает значительно больше времени. Придётся вручную искать повреждённые файлы, сверять с оригинальным дистрибутивом. За 17 лет работы с OpenCart я видел десятки проектов, где отсутствие бэкапа превращало часовую задачу в дневную.

Итог

Включите отображение ошибок PHP и проверьте логи. В 80% случаев белый экран вызван конфликтом модулей или нехваткой памяти. Последовательно отключайте модули пока не найдёте проблемный. Если не удаётся разобраться самостоятельно — обращайтесь, поможем диагностировать и исправить проблему: техническая поддержка OpenCart. Подробнее — PHP-ошибки в OpenCart.