Как включить режим отладки в WordPress

Активация режима отладки требует редактирования одного файла в установке WordPress. Это просто, но нужно делать осторожно, чтобы не повредить сайт. Ниже приведена пошаговая инструкция, как правильно это выполнить.

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

Поиск файла wp-config.php

Первый шаг для включения режима отладки — найти файл wp-config.php. Этот файл находится в корневой папке вашей установки WordPress, там же, где расположены wp-content, wp-includes и wp-admin. Получить доступ к файлу можно с помощью FTP-клиента, файлового менеджера панели хостинга или напрямую, если вы работаете на локальном сервере разработки.

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

Активация WP_DEBUG

Внутри файла wp-config.php прокрутите вниз, пока не найдете строку, похожую на эту: define( 'WP_DEBUG', false );. Эта строка управляет тем, активен ли режим отладки. По умолчанию WordPress отключает отладку по соображениям безопасности и производительности. Чтобы включить её, нужно просто заменить значение false на true.

Правильная строка должна выглядеть так: define( 'WP_DEBUG', true );. После сохранения файла WordPress сразу начнет отображать предупреждения, уведомления и сообщения об ошибках PHP на всем сайте. Это позволит выявить проблемные плагины, темы или пользовательский код.

Использование WP_DEBUG_LOG для записи ошибок

Хотя показ ошибок на экране может быть полезен при разработке, это не всегда удобно. Для долгосрочного мониторинга можно включить WP_DEBUG_LOG. Для этого добавьте следующую строку сразу под константой WP_DEBUG: define( 'WP_DEBUG_LOG', true );. Все ошибки будут записываться в файл debug.log в папке wp-content.

Журнал особенно полезен, если нужно отследить ошибки, возникающие в определенное время, или если их невозможно воспроизвести напрямую на экране. Также это позволяет поделиться файлом с разработчиками или службой поддержки, не предоставляя им доступ к сайту.

Скрытие ошибок от посетителей

Если ваш сайт WordPress работает в продакшене, вы наверняка не хотите, чтобы посетители видели сырые сообщения об ошибках. В этом случае можно добавить еще одну настройку, чтобы отключить их показ на фронтенде: define( 'WP_DEBUG_DISPLAY', false );. Это гарантирует, что ошибки будут записываться, но не показываться пользователям.

Кроме того, можно добавить @ini_set( 'display_errors', 0 );, чтобы усилить этот эффект. Такая комбинация сохраняет сайт профессиональным и безопасным, предоставляя администраторам и разработчикам необходимую информацию в журнале.

Расширенная отладка с SCRIPT_DEBUG

Для разработчиков, работающих с JavaScript и CSS, WordPress предлагает дополнительную константу: define( 'SCRIPT_DEBUG', true );. По умолчанию WordPress загружает сжатые версии скриптов и стилей. Включение отладки скриптов заставляет WordPress использовать полные, несжатые версии, которые легче проверять и отлаживать.

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

В итоге включение режима отладки в WordPress — это простой, но мощный способ диагностировать и поддерживать сайт. Изменив файл wp-config.php, вы сможете отображать ошибки, сохранять их в журналах и сохранять профессиональный вид сайта даже при возникновении проблем. При правильном использовании режим отладки является одним из важнейших инструментов для обеспечения безопасности, стабильности и удобства разработки в WordPress.