Документація

Журнал помилок

Вступ#

Інструмент Журнал помилок дає змогу прямо з адмінки переглядати файл журналу помилок, аналізувати його та розв'язувати проблеми в роботі магазину на ocStore. У журнал потрапляють помилки, попередження та повідомлення PHP, а також помилки, які записують ядро і доповнення. Це допомагає виявляти проблеми з налаштуваннями, конфлікти доповнень і вразливості. Регулярний перегляд журналу — важлива частина підтримки стабільності й безпеки магазину: проблеми вдається виправити раніше, ніж їх помітять покупці.

Як відкрити журнал помилок#

Крок 1. Перейдіть до журналу помилок#

Увійдіть в адмінку і відкрийте Система → Обслуговування → Журнал помилок.

Крок 2. Перегляньте журнал#

На сторінці у полі лише для читання показано вміст файлу журналу помилок.

Крок 3. Керуйте журналом#

Кнопками у верхньому правому куті можна Завантажити файл журналу на комп'ютер або Очистити його вміст.

Огляд інтерфейсу#

сторінка «Журнал помилок» з текстовим полем журналу та кнопками «Завантажити» й «Очистити»

Робота з файлом журналу#

Показ журналу

Один файл журналу

  • Файл журналу: показується файл, заданий у налаштуваннях (за замовчуванням error.log)
  • Тільки для читання: вміст виводиться в текстовому полі, яке не можна редагувати
  • Великі файли: якщо файл має розмір 5 МБ або більше, його вміст не виводиться — замість нього показується попередження з назвою та фактичним розміром файлу. Такий журнал можна завантажити або очистити
  • Оновлення: нові записи з'являються лише після перезавантаження сторінки
Дії з журналом

Керування файлом

  • Перегляд: читання записів журналу прямо в адмінці
  • Завантажити: збереження повного файлу журналу на комп'ютер для аналізу чи архівування
  • Очистити: видалення всього вмісту журналу (сам файл залишається); перед очищенням з'являється запит на підтвердження
Типи журналів і їхнє розташування

Журнали ocStore 3

  • Журнал помилок: основний файл (error.log) — помилки PHP та винятки застосунку
  • Журнал модифікаторів: журнал застосування OCMOD-модифікацій (ocmod.log) переглядається не тут, а в розділі Доповнення → Модифікатори на вкладці Лог
  • Журнали доповнень: деякі доповнення створюють власні файли журналів; на цій сторінці вони не показуються
  • Розташування: журнали зберігаються в теці logs/ сховища ocStore (за замовчуванням system/storage/logs/; якщо під час встановлення теку storage винесено за межі кореня сайту — у відповідній теці там)
  • Налаштування: ім'я файлу журналу та запис помилок налаштовуються в Система → Налаштування на вкладці Сервер (поля Показувати помилки, Записувати помилки, Файл журналу помилок)
Ротація журналів

Для магазинів з великим трафіком налаштуйте ротацію журналів, щоб файли не розросталися надмірно. Стежте за розміром журналу й регулярно очищуйте його або використовуйте засоби ротації на рівні сервера (наприклад, logrotate).

Безпека

Журнал помилок може містити чутливу інформацію (шляхи до файлів, деталі налаштувань, фрагменти даних). Обмежуйте доступ до файлів журналів і ніколи не робіть їх публічно доступними. Завантажуйте й очищуйте журнали лише з довірених пристроїв.

Типові завдання#

Перегляд останніх помилок#

Щоб перевірити поточні проблеми системи:

  1. Відкрийте Система → Обслуговування → Журнал помилок.
  2. Прокрутіть вміст журналу — найновіші записи знаходяться в кінці.
  3. Шукайте закономірності: повторювані помилки свідчать про постійну проблему.
  4. Занотуйте час, тип і текст помилок для подальшого аналізу.

Завантаження журналу для аналізу#

Щоб зберегти журнал для детального аналізу або передати розробнику:

  1. Відкрийте Система → Обслуговування → Журнал помилок.
  2. Натисніть кнопку Завантажити (синя кнопка зі стрілкою).
  3. Файл завантажиться з назвою, що містить назву магазину, дату й час (наприклад, Мій магазин_2026-03-09_12-30-45_error.log).
  4. Передайте файл розробникам або проаналізуйте його спеціальними інструментами.

Очищення журналу#

Щоб звільнити місце на диску й полегшити перегляд нових помилок:

  1. Відкрийте Система → Обслуговування → Журнал помилок.
  2. Натисніть кнопку Очистити (червона кнопка з гумкою).
  3. Підтвердьте очищення в діалоговому вікні.
  4. Вміст журналу буде видалено, а сам файл залишиться для нових записів.

Контроль розміру журналу#

Щоб журнал не займав забагато місця на диску:

  1. Відкрийте Система → Обслуговування → Журнал помилок.
  2. Зверніть увагу на попередження про розмір (з'являється для файлів від 5 МБ).
  3. Перегляньте фактичний розмір файлу в тексті попередження.
  4. Завантажте й очистьте великий журнал або налаштуйте ротацію, якщо файл росте надто швидко.
  5. Якщо журнал заповнюють некритичні повідомлення, усуньте їхню причину або змініть рівень звітування про помилки PHP.

Рекомендації#

Аналіз і моніторинг журналу

Завчасне виявлення проблем

  • Регулярний перегляд: щодня перевіряйте журнал на критичні помилки, щотижня — на закономірності
  • Класифікація: розподіляйте помилки за серйозністю (Fatal error, Warning, Notice) і частотою
  • Пошук причини: пов'язуйте помилки з конкретними доповненнями, власним кодом або змінами налаштувань
  • Тенденції: зростання кількості помилок може сигналізувати про проблему, що поглиблюється
  • Документування: фіксуйте розв'язані проблеми та їхні рішення на майбутнє
Продуктивність і обслуговування

Стратегія керування журналами

  • Контроль розміру: налаштуйте сповіщення на рівні сервера, коли журнал перевищує певний розмір
  • Термін зберігання: визначте, скільки зберігати журнали, з огляду на потреби бізнесу та вимоги законодавства
  • Архівування: перед очищенням завантажуйте важливі журнали для подальшого аналізу
  • Графік очищення: заведіть регулярне очищення (щотижня, щомісяця)
  • Дисковий простір: передбачте достатньо місця для журналів, особливо в пікові сезони
Безпека та відповідність вимогам

Захист даних

  • Контроль доступу: доступ до журналу лише для уповноважених співробітників (через права групи користувачів на tool/log)
  • Персональні дані: журнали можуть містити персональні дані — поводьтеся з ними відповідно до GDPR та інших вимог
  • Безпечне зберігання: зберігайте архівні журнали в зашифрованому вигляді
  • Безпечна передача: передавайте журнали для аналізу лише захищеними каналами
Налагодження та розробка

Ефективне усунення проблем

  • Контекст: фіксуйте, які дії виконувалися, коли виникла помилка
  • Відтворення: записуйте кроки для відтворення нерегулярних помилок
  • Ізоляція доповнень: по черзі вимикайте доповнення та модифікатори, щоб знайти джерело конфлікту
  • Версії: фіксуйте версії ocStore, PHP і доповнень, коли з'являються помилки
  • Звернення по допомогу: надавайте повні відомості про помилку, коли звертаєтеся до сторонніх фахівців
Ризик розкриття даних

Журнал помилок може розкривати системні шляхи, відомості про базу даних та інші чутливі деталі. Ніколи не публікуйте необроблені журнали. Перед передачею третім особам прибирайте з них чутливі дані та переконайтеся, що тека журналів має правильні права доступу і недоступна через веб.

Усунення несправностей#

Журнал не оновлюється або порожній

Проблеми із записом

  • Права доступу: перевірте права на запис для теки logs/ у сховищі ocStore
  • Налаштування ocStore: перевірте, що в Система → Налаштування на вкладці Сервер увімкнено Записувати помилки і вказано Файл журналу помилок
  • Налаштування PHP: частина помилок (наприклад, фатальні помилки до завантаження ocStore) може записуватися лише в журнал PHP або вебсервера — перевірте log_errors і error_log у php.ini
  • Дисковий простір: переконайтеся, що на диску достатньо місця
Не вдається завантажити або очистити журнал

Проблеми з правами

  • Права в адмінці: перевірте, що група користувача має права на перегляд і зміну для tool/log (Система → Користувачі → Групи користувачів)
  • Права на файли: перевірте права на читання та запис файлу журналу
  • Налаштування сервера: деякі конфігурації сервера обмежують операції з файлами
  • Браузер: спробуйте інший браузер або очистьте кеш браузера
Журнал росте надто швидко

Керування розміром

  • Кількість помилок: велика частота помилок указує на проблему, яку треба усунути
  • Рівень звітування: змініть рівень звітування про помилки PHP, щоб зменшити кількість некритичних записів
  • Доповнення: знайдіть і виправте доповнення, які генерують багато помилок (часто це старі доповнення, несумісні з PHP 8)
  • Власний код: перевірте власний код на необроблені винятки та налагоджувальні записи
  • Регулярне очищення: налаштуйте автоматичну ротацію або очищення журналів
Файл журналу відсутній

Наявність файлу

  • Створення файлу: якщо файлу ще немає, сторінка просто порожня — файл з'явиться після першої записаної помилки
  • Структура тек: перевірте, що тека logs/ у сховищі ocStore існує та доступна для запису
  • Ім'я файлу: перевірте Файл журналу помилок у Система → Налаштування на вкладці Сервер
  • Журнали доповнень: деякі доповнення ведуть власні журнали — дивіться документацію доповнення
Не вдається визначити джерело помилок

Розслідування помилок

  • Деталі помилки: звертайте увагу на шлях до файлу та номер рядка в тексті помилки
  • Час: зіставляйте помилки з конкретним часом і діями користувачів
  • Перевірка доповнень: вимикайте доповнення по одному, щоб знайти винуватця
  • База даних: перевірте, чи немає пошкоджених даних або відсутніх записів у базі
  • Інструменти розробника: для складних випадків використовуйте Xdebug або інші засоби налагодження

«Помилки — не поразки, а вісники. Кожен запис у журналі — це нагода зміцнити магазин, закрити вразливості та зробити його надійнішим для покупців».

Сторінку перекладено й адаптовано для ocStore з офіційної документації OpenCart. Ліцензія — GNU GPL v3.
Оновлено: 23.10.2026
На цій сторінці