Поиск
Справочник

WP_DEBUG в WordPress: как увидеть текст ошибки и где журнал debug.log

Когда на сайте белый экран или There has been a critical error on this website, WordPress не показывает, что сломалось. Три строки в wp-config.php включают отладку: WordPress начинает записывать ошибки PHP в файл, и по нему видно, какой плагин или тема виноваты. Здесь — как включить отладку так, чтобы посетители ничего не увидели, и как выключить её после.

≈ 6 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Посмотрите, включена ли отладка:
    sudo grep -n "WP_DEBUG" /var/www/example.com/wp-config.php

    Вместо /var/www/example.com — папка вашего сайта. После установки ответ — одна строка define( 'WP_DEBUG', false );: отладка выключена.

  3. Чтобы найти причину ошибки, включите журнал по шагам ниже.

Что делают три строки

СтрокаЧто делаетЕсли строки нет
WP_DEBUGвключает отладку; без неё две строки ниже не действуютfalse
WP_DEBUG_LOGзаписывать ошибки в файл: true — в wp-content/debug.log, путь в кавычках — в этот файлfalse
WP_DEBUG_DISPLAYпоказывать ошибки прямо на страницах сайтаtrue
Если включить только WP_DEBUG, ошибки появятся на страницах сайта — их увидят посетители, а в тексте ошибок бывают пути к файлам и имена плагинов. На работающем сайте ставьте рядом WP_DEBUG_DISPLAY со значением false.

Как включить журнал ошибок

  1. Создайте папку для журнала вне папки сайта и отдайте её пользователю, от которого работает PHP:
    sudo mkdir -p /var/log/wordpress
    sudo chown www-data:www-data /var/log/wordpress
  2. Сделайте копию wp-config.php и откройте его — по шагам на странице настройки WordPress.
  3. Найдите строку define( 'WP_DEBUG', false ); (Ctrl+W, введите WP_DEBUG, Enter) и замените её тремя строками:
    define( 'WP_DEBUG', true );
    define( 'WP_DEBUG_LOG', '/var/log/wordpress/example.com-debug.log' );
    define( 'WP_DEBUG_DISPLAY', false );

    Именно замените: если оставить старую строку с false, WordPress возьмёт её, а не новую (почему).

  4. Сохраните: Ctrl+O, Enter, Ctrl+X. Проверьте файл: sudo php -l /var/www/example.com/wp-config.php.
  5. Откройте в браузере страницу, на которой ошибка. Файл журнала появится, когда WordPress запишет в него первую ошибку.
  6. Посмотрите последние строки:
    sudo tail -n 20 /var/log/wordpress/example.com-debug.log

    Следить за новыми строками: sudo tail -f /var/log/wordpress/example.com-debug.log, выйти — Ctrl+C.

Как читать журнал

Каждая строка начинается с даты и вида ошибки:

[09-Nov-2026 10:15:02 UTC] PHP Warning:  Undefined variable $title in /var/www/example.com/wp-content/plugins/plugin-name/plugin.php on line 42
ВидЧто значит
PHP Fatal errorPHP остановился — из-за этого белый экран или There has been a critical error
PHP Parse errorошибка в тексте PHP-файла, файл не загрузился
PHP Warningчто-то пошло не так, но страница загрузилась
PHP Notice, PHP Deprecatedподсказки разработчику; на работу сайта не влияют

Главное — путь после in: по нему видно, чей файл. wp-content/plugins/plugin-name/ — плагин plugin-name, wp-content/themes/theme-name/ — тема. Что делать дальше — There has been a critical error.

Строк Deprecated и Notice с включённым WP_DEBUG может быть много. Чтобы найти главное, ищите Fatal:

sudo grep 'Fatal' /var/log/wordpress/example.com-debug.log | tail -n 5

Если журнал в wp-content/debug.log

С define( 'WP_DEBUG_LOG', true ); журнал пишется в /var/www/example.com/wp-content/debug.log — внутри папки сайта. Веб-сервер отдаст этот файл любому, кто откроет https://example.com/wp-content/debug.log. Проверьте:

curl -s -o /dev/null -w '%{http_code}\n' https://example.com/wp-content/debug.log
КодЧто значит
200файл открывается из интернета — закройте его или перенесите журнал
403 или 404файл не открывается — всё в порядке

Лучше перенести журнал в /var/log/wordpress, как в шагах выше, а старый файл удалить: sudo rm /var/www/example.com/wp-content/debug.log.

Если журнал нужен именно в wp-content, закройте файл. В nginx добавьте в блок server своего сайта:

location = /wp-content/debug.log {
    deny all;
}

Затем sudo nginx -t и sudo systemctl reload nginx, и снова проверьте curl: код 403. Как устроены такие блоки — location в nginx. Для Apache — строки в .htaccess (запрет доступа).

Как выключить отладку

Когда причину нашли и исправили:

  1. Откройте wp-config.php: sudo nano /var/www/example.com/wp-config.php.
  2. Замените три строки одной:
    define( 'WP_DEBUG', false );
  3. Сохраните и проверьте: sudo php -l /var/www/example.com/wp-config.php.
  4. Удалите журнал, если он больше не нужен:
    sudo rm /var/log/wordpress/example.com-debug.log

Не оставляйте отладку включённой: с WP_DEBUG журнал растёт с каждой строкой Notice и Deprecated и занимает место на диске (как посмотреть место).

SCRIPT_DEBUG

define( 'SCRIPT_DEBUG', true ); заставляет WordPress подключать полные, несжатые файлы стилей и скриптов своей админки вместо сжатых .min.js и .min.css. Это нужно разработчику, который ищет ошибку в скриптах. Для поиска ошибок PHP эта строка не нужна.

Ошибки и как их исправить

Что видитеПричинаЧто делать
журнал не появляетсяошибок ещё не было или WP_DEBUG осталась falsesudo grep -n "WP_DEBUG" …/wp-config.php: строка WP_DEBUG одна и в ней true
журнал не появляется, WP_DEBUG — truePHP не может писать в папку журналаsudo chown www-data:www-data /var/log/wordpress
ошибки видны на страницах сайтанет строки WP_DEBUG_DISPLAY со значением falseдобавьте её
Constant WP_DEBUG already definedосталась старая строка WP_DEBUGоставьте одну
curl к debug.log даёт код 200журнал внутри папки сайта открыт из интернетаперенесите или закройте
в журнале только Deprecated и Noticeпричина белого экрана не в PHP или ошибка ещё не повториласьоткройте страницу с ошибкой снова и ищите Fatal; посмотрите журнал ошибок nginx
после правки белый экран у всего сайтаошибка в строке wp-config.phpsudo php -l …/wp-config.php или верните копию

Всё сверено с WordPress 7.1.4.

Источники

Сверено 9 ноября 2026 года.

Если выбираете хостинг под WordPress. Что важно в тарифе и нужен ли «специальный» хостинг — в статье Хостинг для WordPress. Один из вариантов — хостинг для WordPress у Timeweb Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs.

Что почитать дальше