Как установить файл для отладки (debug.log) в WordPress и использовать его для поиска ошибок

Автор: Антон Комаров | Опубликовано: 18.02.2026

Отладка WordPress — важный этап при разработке и поддержке сайта. Включение логирования ошибок в файл debug.log помогает выявлять проблемы в работе плагинов, тем и самого движка. В этой статье подробно разберём, как правильно настроить файл отладки, где его найти и как анализировать логи для ускорения решения проблем.

Что такое debug.log и зачем он нужен в WordPress

Файл debug.log — это журнал, в который WordPress записывает ошибки, предупреждения и уведомления, если включена отладка. По умолчанию ошибки могут выводиться прямо на экран, что неудобно и небезопасно для живого сайта. Логирование ошибок в файл позволяет собирать информацию о проблемах без нарушения пользовательского опыта.

Если вы разрабатываете темы или плагины, то использование debug.log — обязательная практика для быстрого обнаружения багов и предупреждений PHP. Также это помогает выявлять несовместимости и устаревшие вызовы функций.

Для включения файла отладки нужно правильно настроить файл wp-config.php. Рассмотрим это в деталях ниже.

Как включить debug.log в WordPress: настройка wp-config.php

Откройте ваш wp-config.php — главный конфигурационный файл WordPress, расположенный в корне сайта. В нём нужно добавить или изменить несколько констант.

Пример правильной настройки для записи ошибок в wp-content/debug.log:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
@ini_set('display_errors', 0);

Пояснения:

WP_DEBUG — включает режим отладки.
WP_DEBUG_LOG — включает запись в файл debug.log.
WP_DEBUG_DISPLAY — отключает вывод ошибок на экран, чтобы посетители сайта их не видели.
@ini_set('display_errors', 0); — дополнительная гарантия, что ошибки не будут выведены.

После внесения изменений сохраните файл и загрузите обратно на сервер.

Где находится файл debug.log и как его просмотреть

По умолчанию WordPress создаёт debug.log в папке wp-content. Если файла нет, он появится при первой ошибке.

Чтобы просмотреть логи, подключитесь к серверу через FTP или используйте файловый менеджер хостинга. Найдите wp-content/debug.log и скачайте или откройте его прямо на сервере.

Файл содержит записи с датой, временем и описанием ошибок, например:

[10-Jun-2024 12:34:56 UTC] PHP Notice:  Undefined variable: var in /home/site/wp-content/themes/mytheme/functions.php on line 45

Регулярно проверяйте этот файл при возникновении проблем, чтобы быстрее находить причину.

Как анализировать debug.log: практические советы

При чтении логов обращайте внимание на следующие моменты:

Тип ошибки: Notice, Warning, Fatal Error — от этого зависит срочность решения.
Файл и строка, где произошла ошибка. Это точка входа для исправления.
Повторяющиеся сообщения — возможно, баг системный.
Ошибки, связанные с плагинами или темами — стоит временно их отключить для проверки.

Для удобства можно фильтровать файл по ключевым словам, например, по названию плагина или функции, используя команду grep или любой текстовый редактор.

Пример: как создать функцию wpmy_debug_log для записи в debug.log из кода

Иногда полезно создавать свои записи в логе для отладки. Для этого можно написать функцию, которая добавляет запись в debug.log. Вставьте в файл functions.php вашей темы или плагина такой код:

function wpmy_debug_log($message) {
    if (defined('WP_DEBUG') && WP_DEBUG) {
        if (is_array($message) || is_object($message)) {
            error_log(print_r($message, true));
        } else {
            error_log($message);
        }
    }
}

Использовать функцию просто:

wpmy_debug_log('Тестовая запись в debug.log');
wpmy_debug_log(array('ключ' => 'значение'));

Это поможет вам вставлять свои сообщения в логи без вывода на экран.

Плагины для упрощения работы с debug.log и отладкой WordPress

Для удобства существуют плагины, которые помогают просматривать и управлять логами прямо из админки:

Debug Log Viewer — позволяет просматривать debug.log из панели управления WordPress без FTP.
Query Monitor — мощный инструмент для отладки запросов, ошибок PHP, хуков и прочего.
Log Deprecated Notices — помогает выявлять устаревшие функции и вызовы.

Все эти плагины доступны на официальном репозитории WordPress или на wpshop.ru с удобной установкой.

Советы по безопасности при работе с debug.log

Файл debug.log может содержать конфиденциальные данные, поэтому не рекомендуется оставлять отладку включённой на живом сайте постоянно. По окончании работ отключайте режим отладки, заменяя в wp-config.php WP_DEBUG и WP_DEBUG_LOG на false.

Также можно защитить файл от прямого доступа через .htaccess, добавив:

<Files debug.log>
    Order allow,deny
    Deny from all
</Files>

Это предотвратит доступ к логу через браузер.

Итоги: как использовать debug.log для эффективной отладки WordPress

Файл debug.log — незаменимый инструмент разработчика для поиска и устранения ошибок. Его правильная настройка и регулярный анализ помогут поддерживать сайт в работоспособном состоянии и быстро реагировать на проблемы. Используйте собственные функции для записи в лог и удобные плагины для просмотра, чтобы сделать процесс максимально комфортным.

Для скачивания полезных плагинов и инструментов посетите wpshop.ru.