Как читать логи ошибок OpenCart

Логи ошибок — главный инструмент диагностики OpenCart. Когда сайт выдаёт белый экран, ошибку 500 или просто странно работает — первое, что нужно сделать, это открыть логи. Я занимаюсь OpenCart с 2009 года, и 90% проблем диагностируются через логи за 15 минут. В этом гайде разберу, где искать логи, как их читать и что делать с каждой типовой ошибкой.

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

Где находятся логи ошибок OpenCart

У OpenCart несколько уровней логирования. Самое важное — знать, где искать на каждом уровне. А что делать, если error.log пустой, а сайт не работает? Значит, ошибка на уровне сервера — и нужно смотреть логи PHP и веб-сервера.

Тип лога	Путь к файлу	Когда смотреть
Лог OpenCart	system/storage/logs/error.log	Notice, Warning, Fatal error, белый экран
Лог PHP	/var/log/php_errors.log или error_log в корне сайта	Синтаксические ошибки, нехватка памяти
Лог Nginx	/var/log/nginx/error.log	502, 504, 403 ошибки
Лог Apache	/var/log/apache2/error.log	500, 403, mod_rewrite ошибки
Лог хостинга	В панели управления хостингом	Если нет доступа к серверу

Основной файл — system/storage/logs/error.log. Именно туда OpenCart пишет все ошибки PHP. Если этот файл пустой, а сайт не работает — проверьте логи PHP или веб-сервера.

Формат записи в логах OpenCart

Каждая запись в error.log выглядит так:

2026-06-30 14:22:10 - PHP Notice: Undefined variable: product_id in /path/to/catalog/model/catalog/product.php on line 45
2026-06-30 14:22:11 - PHP Warning: require(/path/to/module.php): failed to open stream in /path/to/index.php on line 120
2026-06-30 14:22:12 - PHP Fatal error:  Allowed memory size of 134217728 bytes exhausted in /path/to/system/library/db/mysqli.php on line 85

Формат простой: дата время — тип ошибки: сообщение в файле on line номер. Три главных компонента, которые нужно анализировать: тип ошибки, путь к файлу и номер строки.

Типы ошибок PHP: что значат и как реагировать

OpenCart работает на PHP, поэтому все ошибки — это ошибки PHP. Есть несколько типов, и каждый требует своей реакции.

Тип ошибки	Серьёзность	Что значит	Что делать
Notice	Низкая	Использование необъявленной переменной	Часто можно игнорировать, но лучше исправить код
Warning	Средняя	Проблема с файлом или функцией	Проверить путь к файлу, права доступа
Fatal error	Высокая	Сайт не работает	Требует немедленного вмешательства
Parse error	Высокая	Синтаксическая ошибка в PHP-коде	Проверить правки в файле, откатить изменения
Catchable fatal error	Высокая	Ошибка типов в аргументе функции	Исправить вызов функции

Notices можно временно игнорировать, но если их сотни — это влияет на производительность. Warnings и Fatal errors нужно исправлять сразу. Отключение отображения ошибок (display_errors = Off) — не решение, вы просто не видите проблему.

Как анализировать логи: пошаговая инструкция

А что делать, если в логе 10 000 строк и непонятно, с чего начать? Вот алгоритм, который я использую.

Шаг 1. Определите тип ошибки

Fatal error — сайт не работает, нужно исправлять немедленно. Warning — требует внимания, может перерасти в Fatal. Notice — не критично, но лучше почистить.

Шаг 2. Найдите источник

Посмотрите на путь к файлу. Если внутри catalog/model/ — проблема в модели. Если system/library/ — в ядре OpenCart. Если admin/controller/ — в модуле админки. Это сразу указывает, какой модуль или часть кода нужно проверить.

Шаг 3. Проверьте частоту

Одна ошибка при загрузке страницы — может быть случайной. Сто одинаковых ошибок в минуту — системная проблема. Команда grep "Fatal error" error.log | wc -l покажет количество фатальных ошибок в логе.

Шаг 4. Проверьте контекст

Посмотрите на 10–20 строк до и после ошибки. Часто одна ошибка тянет за собой другие. Исправьте первую в цепочке — остальные исчезнут. Например, если файл не подключился, все последующие ошибки — следствие.

Шаг 5. Примите решение

Если ошибка в модуле — отключите модуль и обратитесь к разработчику. Если в ядре — откатите последние изменения. Если нехватка памяти — увеличьте memory_limit. Конкретные решения — ниже.

Типовые ошибки в логах и их решения

Ниже — самые частые ошибки, которые я вижу в логах OpenCart за 17 лет. Собрал их в таблицу с причинами и решениями.

Ошибка в логе	Причина	Решение
Allowed memory size exhausted	Не хватает оперативной памяти для PHP	Увеличить memory_limit в php.ini до 256M–512M
Undefined variable / Undefined index	Использование переменной без проверки	Исправить код: добавить isset() или ??
require(): failed to open stream	Файл не найден или нет прав на чтение	Проверить путь к файлу и права 644/755
Call to undefined function	Функция не существует или модуль не загружен	Проверить, установлен ли модуль, включён ли он
Maximum execution time exceeded	Скрипт выполняется дольше лимита	Увеличить max_execution_time в php.ini
Class not found	Класс не загружен автозагрузчиком	Проверить регистр имени класса и пути к файлу
Cannot modify header information	Вывод до отправки заголовков	Проверить пробелы до <?php и после ?>
PDOException: SQLSTATE	Ошибка подключения к БД или SQL-запроса	Проверить настройки БД, структуру таблиц

Эта таблица покрывает 80% всех ошибок, которые встречаются в OpenCart. Если ваша ошибка не в списке — гуглите её текст вместе с «OpenCart» — скорее всего, кто-то уже сталкивался и решил. Но не копируйте решения слепую — проверяйте совместимость с вашей версией OpenCart и версией PHP.

Полезные команды для анализа логов через SSH

Если у вас есть доступ к серверу по SSH, анализ логов становится быстрым и удобным. Вот команды, которые я использую каждый день.

# Показать последние 50 ошибок
tail -50 system/storage/logs/error.log

# Следить за логами в реальном времени (Ctrl+C для выхода)
tail -f system/storage/logs/error.log

# Найти все фатальные ошибки
grep "Fatal error" system/storage/logs/error.log

# Сколько ошибок за сегодня
grep "2026-07-" system/storage/logs/error.log | wc -l

# Показать ошибки только от конкретного модуля
grep "catalog/model/catalog/product" system/storage/logs/error.log

# Показать последние 100 строк и сохранить в файл
tail -100 system/storage/logs/error.log > errors_tail.txt

Команда tail -f особенно полезна: вы открываете лог, воспроизводите проблему на сайте, и сразу видите, какие ошибки появляются. Это самый быстрый способ найти причину белого экрана или ошибки 500.

Типичные ситуации из практики

Белый экран в админке

Клиент жалуется, что админка OpenCart не открывается — белый экран. Открываю error.log — там ошибка нехватки памяти (Allowed memory size of 134217728 bytes exhausted). Увеличиваю memory_limit в php.ini с 128M до 256M — админка работает. Всё. Без логов пришлось бы перебирать модули и настройки часами.

Ошибка 500 после обновления модуля

Владелец магазина обновил модуль фильтрации товаров. После обновления сайт выдаёт 500 на страницах каталога. В логе — Call to undefined function. Причина: модуль требует PHP 8.2+, а на сервере стоит PHP 8.0. Решение: откатить модуль до совместимой версии или обновить PHP.

Лог вырос до 2 ГБ

Частая ситуация: владелец замечает, что место на диске закончилось. Открывает error.log — а он весит 2 ГБ. Очищает лог, через неделю — снова 2 ГБ. Проблема: модуль генерирует тысячи Notice в минуту. Решение: отключить проблемный модуль или настроить логирование только для Fatal errors.

Эти ситуации — реальные кейсы из нашей практики. Без логов диагностика заняла бы часы, с логами — 10–15 минут. Если лень разбираться самому — мы проводим технический аудит и находим проблемы за вас.

Как настроить логирование в OpenCart

Логирование может быть включено или выключено. По умолчанию в OpenCart 3 и 4 оно включено, но уровень может быть разным. Где настраивается:

1. Зайдите в админку: Система → Настройки → Сервер
2. Найдите поле «Логирование» — включите.
3. Укажите путь к файлу лога (по умолчанию system/storage/logs/error.log).
4. Если лог пустой, проверьте, не отключено ли логирование на уровне хостинга.

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

Антон Баринов — разработчик интернет-магазинов на OpenCart с 2009 года, основатель opencart-cms.ru.