Привіт:) Відлагодження коду використовують, щоб знайти та виправити помилки в роботі сайту, для його оптимізації та прискорення, при додаванні чи доопрацюванні функціоналу. У цій замітці покажу, як увімкнути режим відлагодження WordPress.
Що таке відлагоджувач (debug) і для чого потрібний
Це набір інструментів, які дозволяють переглянути зсередини роботу сайту. Відлагодження можна порівняти з рентгеном або аналізом крові, які допомагають дізнатися причину хвороби.
Debug-режим найчастіше використовують, щоб з'ясувати, чому не працює (або працює не так, як потрібно) той чи інший функціонал. Наприклад, що робити, якщо після оновлення теми чи плагіну не вдається увійти до адмін-панелі?
Під час роботи сайту часто трапляються помилки. Це може статися через збій на хостингу, додавання нових або зміни старих функцій, оновлення WP, плагінів. Тому важливо завжди бути в курсі цих помилок, щоб вчасно їх виправити і забезпечити безперебійну роботу веб-ресурсу.
Ще відлагодження необхідне під час розробки плагінів і тем ВордПрес. Воно "примушує" програмістів дотримуватися рекомендованих стандартів, щоб у результаті програмний код був максимально якісним.
back to contents ↑Як увімкнути режим відлагодження WordPress
У ядрі WordPress вже вбудований відлагоджувач, але за замовчуванням він вимкнений. Розберу, як із ним працювати.
Зазвичай повідомлення про помилки не повинні виводитися на екрані в користувацькій частині сайту. Це відволікає відвідувачів та ставить під загрозу злому. Зручно список та опис помилок (якщо вони є) отримувати в окремому файлі, доступ до якого має лише адміністратор.
Перед подальшими діями рекомендую створити повну резервну копію сайту.
- Перейдіть до кореневого каталогу свого сайту та відкрийте файл
wp-config.php.
- У рядку
define( 'WP_DEBUG', false );значення false замініть на true.
Повідомлення про всі помилки з'являтимуться на веб-сайті. Щоб їх приховати від користувачів і зручно помістити в один файл, додайте нижче рядки
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );- Щоб усі повідомлення про помилки (логи) збиралися в одному файлі, додайте код
define( 'WP_DEBUG_LOG', true );- Якщо необхідно логувати всі SQL запити, то наступна директива зберігатиме їх у змінну
$wpdb->queriesяк масиву. У цьому масиві можна буде подивитися всі SQL запити сторінки, а також дані про те, скільки часу зайняв запит і якою функцією він був викликаний.
define( 'SAVEQUERIES', true );SQL-запити зможете повитися за допомогою коду:
global $wpdb;
print_r($wpdb->queries);
- Збережіть зміни.
Тепер їх усі можна переглянути у /wp-content/debug.log.
Шлях /wp-content/debug.log для розміщення лог-файлу заданий за замовчуванням. Якщо він не влаштовує, то рядок
define( 'WP_DEBUG_LOG', true );
замініть наdefine( 'WP_DEBUG_LOG', '/home/public_html/wp-content/wp-errors.log' );
В останньому параметрі задайте власний шлях до файлу помилок.
Повний код:
// Увімкнути режим відлагодження
define( 'WP_DEBUG', true );
// Заборонити виведення помилок на екран
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );
// Увімкнути логування помилок у файлі /wp-content/debug.log
define( 'WP_DEBUG_LOG', true );
// Логувати SQL запити
define( 'SAVEQUERIES', true );Якщо не працює WP_DEBUG
Іноді директива WP_DEBUG у wp-config.php може не працювати, і помилки не відображатимуться. Причиною може бути перевизначення десь у коді плагінів чи тем параметрів їх показу. Наприклад, помилки можуть бути вимкнені ini-директивами PHP:
error_reporting(0); // вимкнення повідомлень про помилки
ini_set('display_errors', 0); // вимкнення виведення помилок на екранУ цьому випадку режим відлагодження (дебагу) WordPress "перебиваються", і він перестає працювати.
Для вирішення проблеми найкраще знайти де змінюються налаштування та видалити такі рядки, щоб далі працювати лише з константою WP_DEBUG.
Якщо неможливо знайти місце перевизначення, можна спробувати ще раз "перебити" параметри виведення помилок, вказавши їх знову:
error_reporting(E_ALL); // увімкнення повідомлень про помилки
ini_set('display_errors', 1); // увімкнення виведння помилок на екран