WP_DEBUG в WordPress: как увидеть текст ошибки и где журнал debug.log
Когда на сайте белый экран или There has been a critical error on this website, WordPress не показывает, что сломалось. Три строки в wp-config.php включают отладку: WordPress начинает записывать ошибки PHP в файл, и по нему видно, какой плагин или тема виноваты. Здесь — как включить отладку так, чтобы посетители ничего не увидели, и как выключить её после.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите, включена ли отладка:
sudo grep -n "WP_DEBUG" /var/www/example.com/wp-config.phpВместо
/var/www/example.com— папка вашего сайта. После установки ответ — одна строкаdefine( 'WP_DEBUG', false );: отладка выключена. - Чтобы найти причину ошибки, включите журнал по шагам ниже.
Что делают три строки
| Строка | Что делает | Если строки нет |
|---|---|---|
WP_DEBUG | включает отладку; без неё две строки ниже не действуют | false |
WP_DEBUG_LOG | записывать ошибки в файл: true — в wp-content/debug.log, путь в кавычках — в этот файл | false |
WP_DEBUG_DISPLAY | показывать ошибки прямо на страницах сайта | true |
WP_DEBUG, ошибки появятся на страницах сайта — их увидят посетители, а в тексте ошибок бывают пути к файлам и имена плагинов. На работающем сайте ставьте рядом WP_DEBUG_DISPLAY со значением false.Как включить журнал ошибок
- Создайте папку для журнала вне папки сайта и отдайте её пользователю, от которого работает PHP:
sudo mkdir -p /var/log/wordpress sudo chown www-data:www-data /var/log/wordpress - Сделайте копию wp-config.php и откройте его — по шагам на странице настройки WordPress.
- Найдите строку
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 возьмёт её, а не новую (почему). - Сохраните:
Ctrl+O, Enter,Ctrl+X. Проверьте файл:sudo php -l /var/www/example.com/wp-config.php. - Откройте в браузере страницу, на которой ошибка. Файл журнала появится, когда WordPress запишет в него первую ошибку.
- Посмотрите последние строки:
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 error | PHP остановился — из-за этого белый экран или 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 (запрет доступа).
Как выключить отладку
Когда причину нашли и исправили:
- Откройте wp-config.php:
sudo nano /var/www/example.com/wp-config.php. - Замените три строки одной:
define( 'WP_DEBUG', false ); - Сохраните и проверьте:
sudo php -l /var/www/example.com/wp-config.php. - Удалите журнал, если он больше не нужен:
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 осталась false | sudo grep -n "WP_DEBUG" …/wp-config.php: строка WP_DEBUG одна и в ней true |
журнал не появляется, WP_DEBUG — true | PHP не может писать в папку журнала | 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.php | sudo php -l …/wp-config.php или верните копию |
Всё сверено с WordPress 7.1.4.
Источники
- Справка WordPress: отладка — на английском: WP_DEBUG, WP_DEBUG_LOG, WP_DEBUG_DISPLAY и SCRIPT_DEBUG.
- Исходный код WordPress 7.1.4: load.php — на английском: функция wp_debug_mode, путь к журналу.
- Исходный код WordPress 7.1.4: default-constants.php — на английском: значения, если строк нет.
Сверено 9 ноября 2026 года.
Что почитать дальше
- There has been a critical errorчто делать, когда в журнале нашли виновника.
- Ошибки WordPressнайдите свою ошибку и исправьте по шагам.
- Настройки WordPressвсе настройки на одной странице.