Увімкнення режиму налагодження потребує редагування одного файлу у вашій інсталяції WordPress. Це просто, але слід діяти обережно, щоб не пошкодити сайт. Нижче наведено покрокові інструкції, як зробити це правильно.
Після активації ви зможете вести журнал помилок, приховувати їх від відвідувачів та контролювати, як WordPress обробляє інформацію для налагодження. Це особливо важливо на робочих сайтах, де помилки мають фіксуватися, але не показуватися публічно.
Пошук файлу wp-config.php
Перший крок для увімкнення режиму налагодження — знайти файл wp-config.php. Цей файл розташований у кореневій папці вашої інсталяції WordPress, там само, де знаходяться wp-content, wp-includes і wp-admin. Ви можете отримати доступ до нього за допомогою FTP-програми, файлового менеджера у панелі хостингу або локально, якщо працюєте на сервері розробки.
Рекомендується створити резервну копію цього файлу перед внесенням змін. Один пропущений символ може зламати ваш сайт, а резервна копія забезпечить можливість миттєвого відновлення. Знайшовши файл, відкрийте його у текстовому редакторі та підготуйтеся до зміни конфігурації.
Активація WP_DEBUG
У файлі wp-config.php прокрутіть вниз, доки не знайдете рядок: define( 'WP_DEBUG', false );. Цей рядок визначає, чи увімкнено режим налагодження. За замовчуванням WordPress вимикає його з міркувань безпеки та продуктивності. Щоб увімкнути, просто змініть значення з false на true.
Правильний рядок має виглядати так: define( 'WP_DEBUG', true );. Після збереження файлу WordPress відразу почне відображати попередження, повідомлення та помилки PHP на всьому сайті. Це допоможе визначити проблемні плагіни, теми або користувацький код.
Використання WP_DEBUG_LOG для журналу помилок
Показ помилок на екрані може бути корисним під час розробки, але не завжди зручним. Для довготривалого моніторингу можна увімкнути WP_DEBUG_LOG. Для цього додайте наступний рядок одразу під константу WP_DEBUG: define( 'WP_DEBUG_LOG', true );. Це збереже всі помилки у файлі debug.log у директорії wp-content.
Журнал особливо корисний, коли потрібно відстежити помилки, що виникають у певний час, або які неможливо відтворити безпосередньо на екрані. Також він дозволяє ділитися файлом із розробниками чи службами підтримки без надання їм прямого доступу до сайту.
Приховування помилок від відвідувачів
Якщо ваш сайт WordPress працює у продакшні, ви, ймовірно, не хочете, щоб відвідувачі бачили сирі повідомлення про помилки. У такому випадку можна додати ще одне налаштування, щоб вимкнути показ на фронтенді: define( 'WP_DEBUG_DISPLAY', false );. Це забезпечить запис помилок у журнал без їх показу користувачам.
Додатково можна додати @ini_set( 'display_errors', 0 ); для посилення цієї поведінки. Така комбінація дозволяє зберегти професійний і безпечний вигляд сайту, водночас надаючи потрібну інформацію у журналі налагодження адміністраторам і розробникам.
Розширене налагодження з SCRIPT_DEBUG
Для розробників, які працюють із JavaScript і CSS, WordPress пропонує додаткову константу: define( 'SCRIPT_DEBUG', true );. За замовчуванням WordPress завантажує стиснені версії скриптів і стилів. Увімкнення налагодження скриптів примусить WordPress завантажувати повні, нестиснені версії, які легше перевіряти й налагоджувати.
Це налаштування корисне, якщо ви розробляєте тему чи плагін і потрібно відстежувати роботу скриптів і стилів. Звичайним користувачам воно здебільшого не потрібне, але для розробників може мати велике значення у вирішенні проблем із фронтендом.
Підсумовуючи, увімкнення режиму налагодження у WordPress — це простий, але потужний спосіб діагностувати та обслуговувати ваш сайт. Редагуючи файл wp-config.php, ви можете відображати помилки, зберігати їх у журналах і зберігати професійний вигляд сайту навіть у разі проблем. При правильному використанні режим налагодження є одним із найважливіших інструментів для підтримки WordPress у безпечному, стабільному й зручному для розробників стані.
