Инструменты отладки WordPress: от WP_DEBUG до Xdebug

Белый экран, «критическая ошибка на сайте», медленная страница или плагин, который ведёт себя странно. Чтобы найти причину, нужно видеть, что происходит внутри WordPress. Вот инструменты, которыми я пользуюсь.

Режим отладки WordPress

В wp-config.php есть несколько констант для отладки:

define( 'WP_DEBUG', true );          // включить отладку
define( 'WP_DEBUG_LOG', true );      // писать ошибки в wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // не показывать ошибки посетителям
define( 'SCRIPT_DEBUG', true );      // загружать несжатые JS и CSS
define( 'SAVEQUERIES', true );       // сохранять SQL-запросы для анализа

На рабочем сайте всегда держите WP_DEBUG_DISPLAY выключенным: сообщения об ошибках раскрывают пути и структуру сайта. Лог debug.log закройте от доступа извне или перенесите за пределы корня сайта, указав путь вместо true.

Смотреть лог удобно в реальном времени:

tail -f wp-content/debug.log

Режим восстановления

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

Query Monitor

Query Monitor это главный плагин для отладки. Он показывает в админ-панели:

  • все SQL-запросы, их время и какой плагин их вызвал;
  • ошибки и предупреждения PHP;
  • подключённые скрипты и стили;
  • хуки, HTTP-запросы к внешним API, использование памяти.

Медленный сайт почти всегда удаётся разобрать за несколько минут: видно, какой плагин делает сотню запросов.

Похожий набор, Debug Bar с дополнениями, сейчас используется реже.

Консоль браузера

Инструменты разработчика (F12) показывают ошибки JavaScript, неудачные сетевые запросы и проблемы с загрузкой файлов. Если не работает редактор блоков или форма, начните отсюда: вкладки Console и Network.

WP-CLI

WP-CLI помогает, когда админка недоступна:

wp plugin deactivate --all       # отключить все плагины
wp theme activate twentytwentyfour
wp plugin activate имя-плагина   # включать по одному, пока не найдёте виновника
wp core verify-checksums         # проверить файлы ядра
wp eval 'var_dump( get_option( "siteurl" ) );'

Логи сервера

Ошибки PHP-FPM и Nginx часто не попадают в debug.log:

tail -f /var/log/nginx/error.log
tail -f /var/log/php8.3-fpm.log

Xdebug

Для сложных случаев нужен пошаговый отладчик Xdebug: точки останова, просмотр переменных, профилирование. Он подключается к VS Code или PhpStorm. Включайте его только на локальной или тестовой копии, он сильно замедляет PHP. Типичные ошибки при настройке разобраны в заметке о Xdebug, а локальная среда для этого описана в заметке о DDEV.

Порядок действий

  1. Включить запись ошибок в лог.
  2. Посмотреть debug.log и логи сервера.
  3. Отключить плагины и переключить тему, чтобы найти виновника.
  4. Для медленных страниц открыть Query Monitor.
  5. Для сложной логики подключить Xdebug на тестовой копии.

Источники и ссылки


Комментарии загружаются…