Простий спосіб налагодження сайту на WordPress
Якщо ви працюєте над темою або плагіном в WordPress і вважаєте себе хорошим розробником, значить ви напевно використовуєте налагодження. Якщо ви тільки розробник-початківець на ВордПрес, тоді вам настійно рекомендується його використовувати. Головне не забувайте, що налагодження призначено для локального використання і не повинно використовуватися на сайті в мережі Інтернет. Для цих цілей краще всього підходить локальний сервер, наприклад, на базі Денвер, XAMPP та схожих інструментах веб-розробника.
На жаль, не всі розробники слідують цій пораді, можливо через те, що забувають про інструменти налагодження, вбудовані в WordPress, або ж просто не знають, як їх використовувати.
Якщо ви не знаєте як використовувати вбудоване налагодження в двигуні ВордПрес, значить вам може стати в нагоді інформація з даної публікації.
Налагодження за допомогою WP_DEBUG
Найважливіший інструмент налагодження в WordPress – це функція WP_DEBUG
.
WP_DEBUG
– це булева константа, яка запускає режим налагодження у всьому сайті на WordPress. WP_DEBUG надає зручний спосіб усунення неполадок, коли щось не так з вашим сайтом. Ця функція включається в файлі wp-config.php
в корені сайту.
Щоб включити режим налагодження WP_DEBUG, знайдіть наступний рядок коду у файлі wp-config.php
:
define ('WP_DEBUG', false);
Потім замініть false
на true
і збережіть файл.
Коли встановлено значення true
, ви будете бачити повідомлення PHP, наприклад про критичні помилки в коді або ж про використання застарілих функцій.
Застарілі функції, які містяться в різних версіях WordPress, стають такими після внесення змін в ядро CMS, або ж після зміни сумісності з більш новими версіями PHP. Важливо виявляти такі функції і замінювати їх на більш сучасний аналог (а значить, на більш безпечний або швидший).
Щоб відключити константу, просто замініть true
на false
. За замовчуванням для WP_DEBUG встановлено значення false
.
Ведення журналу помилок за допомогою WP_DEBUG_LOG
Іншим зручним інструментом є WP_DEBUG_LOG
, який може використовуватися спільно з WP_DEBUG для збереження всіх повідомлень про помилки у файлі debug.log
. Це особливо корисна функція, якщо ви хочете розбирати помилки пізніше, а не під час роботи з сайтом.
Щоб включити ведення журналу помилок, просто додайте наступний рядок коду в файл wp-config.php
:
define ('WP_DEBUG_LOG', true);
Після того, як ви включили це налаштування, ви знайдете журнал помилок debug.log
в каталозі /wp-content/
вашого сайту.
Відображення помилок на сайті за допомогою WP_DEBUG_DISPLAY
Якщо ви не хочете, щоб повідомлення про помилки показувалися прямо в браузері на сторінках вашого сайту, ви повинні використовувати WP_DEBUG_DISPLAY
. Це ще одна корисна константа, яка дозволяє вам контролювати відображення налагоджувальних повідомлень всередині HTML-коду вашого сайту. Значення за замовчуванням true
показує помилки і попередження по мірі їх появи. Зміна цього параметра на false
приховає всі помилки.
Ця константа повинна використовуватися в поєднанні з WP_DEBUG_LOG
.
Щоб використовувати цю функцію, просто додайте наступний рядок коду в файл wp-config.php
:
define ('WP_DEBUG_DISPLAY', false);
Всі налагоджувальні налаштування разом
Ось так виглядають всі три налаштування разом:
// включаємо налагодження define ('WP_DEBUG', true); // говоримо WordPress, щоб він записував все помилки в /wp-content/debug.log define ('WP_DEBUG_LOG', true); // відключаємо показ повідомлень про помилки на сайті в браузері define ('WP_DEBUG_DISPLAY', false); // також ми можемо примусово змусити ВордПрес не показувати помилки на екрані @ini_set ('display_errors', 0);
Важливо пам’ятати, що функції налагодження не слід використовувати на сайті в мережі Інтернет. Ці функції корисні під час розробки, але вони можуть бути небезпечні на реальному сайті, оскільки зловмисники матимуть доступ до важливої інформації про ваш код, шляхи до файлів і т.п.