Белый экран, «критическая ошибка на сайте», медленная страница или плагин, который ведёт себя странно. Чтобы найти причину, нужно видеть, что происходит внутри 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.
Порядок действий
- Включить запись ошибок в лог.
- Посмотреть
debug.logи логи сервера. - Отключить плагины и переключить тему, чтобы найти виновника.
- Для медленных страниц открыть Query Monitor.
- Для сложной логики подключить Xdebug на тестовой копии.