Простой способ отладки сайта на WordPress

Если вы работаете над темой или плагином в WordPress и считаете себя хорошим разработчиком, значит вы наверняка используете отладку. Если вы только начинающий разработчик ВордПресс, тогда вам настоятельно рекомендуется ее использовать. Главное не забывайте, что отладка предназначена для локального использования и не должна использоваться на сайте в сети Интернет. Для этих целей лучше всего подходит локальный сервер, например, на базе Денвер, XAMPP и похожих инструментах веб-разработчика.

К сожалению, не все разработчики следуют этому совету, возможно из-за того, что забывают об инструментах отладки, встроенных в WordPress, или же просто не знают, как их использовать.

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

Отладка с помощью WP_DEBUG

Самый важный инструмент отладки в WordPress – это функция WP_DEBUG.

WP_DEBUG – это булева константа, которая запускает режим отладки во всем сайте на WordPress. WP_DEBUG предоставляет удобный способ устранения неполадок, когда что-то не так с вашим сайтом. Данная функция включается в файле wp-config.php в корне сайта.

Чтобы включить режим отладки WP_DEBUG, найдите следующую строку кода в файле wp-config.php:

define ('WP_DEBUG', false);

Затем замените false на true и сохраните файл.

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

Устаревшие функции, которые содержатся в разных версиях WordPress, становятся такими после внесения изменений в ядро CMS, или же после изменения совместимости с более новыми версиями PHP. Важно выявлять такие функции и заменять их на более современный аналог (а значит, на более безопасный или более быстрый).

Чтобы отключить константу, просто замените true на false. По умолчанию для WP_DEBUG установлено значение false.

Ведение журнала ошибок с помощью WP_DEBUG_LOG

Другим удобным инструментом является WP_DEBUG_LOG, который может использоваться совместно с WP_DEBUG для сохранения всех сообщений об ошибках в файле debug.log. Это особенно полезная функция, если вы хотите разбирать ошибки позже, а не во время работы с сайтом.

Чтобы включить ведение журнала ошибок, просто добавьте следующую строку кода в файл wp-config.php:

define ('WP_DEBUG_LOG', true);

После того, как вы включили данную настройку, вы найдете журнал ошибок debug.log в каталоге /wp-content/ вашего сайта.

Отображение ошибок на сайте с помощью WP_DEBUG_DISPLAY

Если вы не хотите, чтобы сообщения об ошибках показывались прямо в браузере на страницах вашего сайта, вы должны использовать WP_DEBUG_DISPLAY. Это еще одна полезная константа, которая позволяет вам контролировать, отображаются ли отладочные сообщения внутри HTML-кода вашего сайта. Значение по умолчанию true показывает ошибки и предупреждения по мере их появления. Изменение этого параметра на false скроет все ошибки.

Эта константа должна использоваться в сочетании с WP_DEBUG_LOG.

Чтобы использовать эту функцию, просто добавьте следующую строку кода в файл wp-config.php:

define ('WP_DEBUG_DISPLAY', false);

Все отладочные настройки вместе

Вот так выглядят все три настройки вместе:

// включаем отладку
define ('WP_DEBUG', true);
// говорим WordPress, чтобы он записывал все ошибки в /wp-content/debug.log
define ('WP_DEBUG_LOG', true);
// отключаем отображение сообщений об ошибках на сайте в браузере
define ('WP_DEBUG_DISPLAY', false);
// также мы можем принудительно заставить ВордПресс не показывать ошибки на экране
@ini_set ('display_errors', 0);

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