OpenCart на сервере: частые ошибки и решения

MAATRIX

OpenCart прост и надёжен, но у интернет-магазина на сервере свой набор типичных проблем: белый экран, ошибка соединения с базой, установщик не пишет config, конфликты HTTPS и корзины, 500 при включении SEO-ссылок или сбои прав доступа. Практически все частые ошибки OpenCart объясняются понятными причинами — PHP, база, config-файлы, SSL, права — и решаются проверенным набором действий. Разберём их по порядку, начиная с самых частых, с командами и указанием, где искать логи. Для магазина это особенно важно: простой напрямую бьёт по продажам. Где искать причины. Ошибки PHP пишутся в лог веб-сервера: /var/log/apache2/error.log или /var/log/nginx/error.log. У OpenCart есть собственный журнал ошибок в админке (Отчёты → Журнал ошибок) и файл system/storage/logs/error.log. Для отладки в файлах config.php и admin/config.php можно временно включить отображение ошибок. Первый шаг при любом сбое — заглянуть в лог веб-сервера и журнал OpenCart, а не гадать по внешнему симптому вроде пустой страницы или сломанной корзины.

Белый экран или ошибка 500

Сайт открывается пустой белой страницей или отдаёт 500 — следствие фатальной ошибки PHP. Причины: конфликт модуля, несовместимая версия PHP, нехватка памяти или ошибка в шаблоне. Первым делом включите отображение ошибок, отредактировав настройки в config.php, и обновите страницу — появится текст с указанием файла и строки.

Частая причина после переезда или обновления — несовместимая версия PHP: у каждой версии OpenCart свои требования, и слишком новый или старый PHP даёт фатальные ошибки. Проверьте, какую версию PHP ожидает ваш OpenCart. Вторая причина — нехватка памяти PHP, увеличьте memory_limit до 256M и перезапустите веб-сервер:

systemctl restart apache2

Если ошибку даёт конкретное расширение или тема, отключите их: модификации OpenCart (OCMOD) можно очистить, удалив их через админку или очистив кэш модификаций в разделе Модули → Модификации → обновить.

Установщик не может записать config

Классическая ошибка новичка: веб-установщик пишет, что не может записать конфигурационные файлы. Причина в том, что не переименованы образцы конфигов. OpenCart поставляет их как config-dist.php, и установщик пишет именно в config.php. Переименуйте оба файла:

cd /var/www/vashdomen.ru
mv config-dist.php config.php
mv admin/config-dist.php admin/config.php

Затем убедитесь, что владельцем файлов является пользователь веб-сервера, иначе PHP не сможет в них писать:

chown www-data:www-data config.php admin/config.php
chmod 644 config.php admin/config.php

После этого установщик успешно запишет параметры базы и путей. Это самая частая причина, по которой установка OpenCart «не идёт» на чистом сервере.

Ошибка соединения с базой данных

Магазин пишет об ошибке подключения к базе или «Unable to connect to database». Проверьте параметры подключения в config.php и admin/config.php — там прописаны хост, имя базы, пользователь и пароль. Опечатка или смена пароля пользователя базы — частая причина. Проверьте, запущена ли СУБД:

systemctl status mysql

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

df -h

Для магазина это критично: покупатель не может завершить заказ. Почистите старые логи (в том числе разросшийся system/storage/logs/error.log), бэкапы и кэш. Настройте мониторинг свободного места, чтобы переполнение не застало врасплох в разгар продаж. Отдельно отметим: файл журнала ошибок OpenCart способен разрастись до гигабайтов, если в магазине есть модуль, сыплющий ошибками на каждый запрос. Поэтому если диск забивается подозрительно быстро, первым делом проверьте размер error.log — часто именно он съедает место, а заодно указывает на сбойное расширение, которое стоит починить или отключить.

Проблемы HTTPS и «сломанной» корзины

После выпуска SSL магазин ведёт себя странно: корзина сбрасывается, оплата не проходит, часть страниц по http, часть по https, браузер ругается на смешанный контент. Причина — адрес магазина не полностью переведён на https. Пропишите https в константах адреса в config.php и admin/config.php, а также включите использование SSL в админке (Система → Настройки → магазин → вкладка Сервер).

Смешанный контент (когда https-страница подгружает http-ресурсы) ломает «замочек» безопасности и отпугивает покупателей. Проверьте, что все ссылки на изображения, стили и скрипты идут по https. Если магазин за Cloudflare или прокси, переведите его в режим Full SSL, иначе возможен бесконечный редирект между сервером и CDN. Корректный сквозной HTTPS — обязательное условие рабочего магазина.

Ошибка 500 при включении SEO-ссылок

Включили человекочитаемые URL (SEO URL), и магазин стал отдавать 500 или ссылки перестали работать. Причина — не активирован модуль перезаписи Apache или отсутствует .htaccess. Убедитесь, что rewrite включён:

a2enmod rewrite
systemctl restart apache2

OpenCart поставляет файл .htaccess.txt — его нужно переименовать в .htaccess в корне магазина. Также в конфиге виртуального хоста должно стоять AllowOverride All. На Nginx .htaccess не работает — правила ЧПУ задаются в конфиге Nginx отдельным блоком. После этого включите SEO URL в админке (Система → Настройки → Сервер) и пропишите SEO-ключевые слова для товаров и категорий.

Права доступа и нехватка ресурсов

OpenCart не загружает изображения товаров, не сохраняет настройки или пишет об ошибках записи — проблема с правами. Владельцем каталога магазина должен быть www-data. Особое внимание к каталогам, куда OpenCart пишет: system/storage/ (логи, кэш, загрузки) и image/. Восстановите владельца:

chown -R www-data:www-data /var/www/vashdomen.ru

По ресурсам: если магазин тормозит, а под нагрузкой ловит 502/503, проверьте память командой free -m. Включите кэширование в OpenCart, оптимизируйте изображения и базу. В дни распродаж трафик кратно растёт, и серверу нужен запас мощности — нехватка памяти в пик продаж означает потерянные заказы. На VPS MAATRIX ресурсы наращиваются без переустановки, в том числе временно под акцию.

Частые вопросы