Как отловить и исправить ошибки PHP в WordPress

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

Включение отображения ошибок PHP в WordPress

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

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
@ini_set('display_errors', 0);

Так ошибки будут записываться в файл wp-content/debug.log, но не отображаться на сайте, что безопаснее для продакшена. Если вы работаете на локальном сервере или тестовом сайте, можно включить WP_DEBUG_DISPLAY в true, чтобы ошибки показывались прямо на странице.

После включения отладки зайдите на проблемные страницы и проверьте содержимое debug.log. Там вы увидите подробные сообщения об ошибках PHP, предупреждения и уведомления.

Использование плагинов для мониторинга и отладки PHP ошибок

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

• Query Monitor — один из лучших инструментов для отладки WordPress. Он показывает ошибки PHP, запросы к базе данных, хуки и многое другое прямо в админ-панели. Особенно полезен для выявления вызовов с ошибками.
• Debug Bar — добавляет панель отладки с информацией об ошибках, запросах и хуках. Можно расширить плагин дополнительными аддонами для более подробного анализа.
• Log Deprecated Notices — фиксирует устаревшие функции и параметры, которые могут вызывать ошибки в будущем.

Для установки плагина перейдите в админку WordPress в раздел «Плагины» → «Добавить новый», найдите нужный плагин и установите его. После активации вы увидите новые инструменты для отладки.

Практические примеры отлова и исправления ошибок PHP

Пример 1. Ошибка «Call to undefined function»

Частая ошибка возникает, когда вызывается функция, которая не подключена или отсутствует. Например:

function wpmonitor_get_custom_data() {
    return my_custom_function(); // Ошибка, если my_custom_function не определена
}

Чтобы отловить и исправить:

1. Проверьте, подключён ли файл с определением my_custom_function(). Если нет — подключите через require_once или добавьте определение функции.
2. Используйте function_exists() для проверки перед вызовом:

function wpmonitor_get_custom_data() {
    if (function_exists('my_custom_function')) {
        return my_custom_function();
    } else {
        error_log('my_custom_function не определена');
        return false;
    }
}

Пример 2. Ошибка синтаксиса в PHP

Синтаксические ошибки часто вызывают "Parse error" и приводят к белому экрану. Например, пропущенная скобка:

function wpmonitor_syntax_error() {
    echo 'Hello World';
 // пропущена закрывающая скобка

Исправьте её, внимательно проверив код в редакторе или IDE с подсветкой синтаксиса. Для локализации ошибки используйте debug.log — там всегда указывается строка с ошибкой.

Пример 3. Отлов ошибок при AJAX-запросах

Ошибки PHP в AJAX-запросах не видны напрямую. Чтобы отладить, можно добавить вывод ошибок в ответ:

add_action('wp_ajax_wpmonitor_test_ajax', 'wpmonitor_test_ajax_handler');
function wpmonitor_test_ajax_handler() {
    ini_set('display_errors', 1);
    error_reporting(E_ALL);

    // Пример ошибки
    echo undefined_variable;

    wp_die();
}

Так вы увидите ошибку в ответе AJAX и сможете её исправить.

Автоматизация мониторинга ошибок с помощью WPMonitor

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

Плагин интегрируется с популярными системами уведомлений и предоставляет удобный интерфейс для просмотра истории ошибок.

Советы по предотвращению ошибок PHP в WordPress

Проверяйте код перед загрузкой на сайт

Используйте локальную среду разработки с включённой отладкой и инструментами проверки синтаксиса. IDE, такие как PhpStorm или VSCode с расширениями для PHP, помогут выявить ошибки ещё до публикации.

Используйте child-темы и тестовые сайты

Вносите изменения сначала в дочерние темы и на тестовых копиях сайта, чтобы не ломать рабочий ресурс.

Ограничивайте права доступа

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

Регулярно обновляйте плагины и темы

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

Выводы

Отладка ошибок PHP — важный навык разработчика WordPress. Используйте встроенные механизмы WP_DEBUG, комбинируйте с удобными плагинами, такими как Query Monitor и WPMonitor, чтобы быстро выявлять и исправлять ошибки. Примеров кода и рекомендаций в статье хватит для решения большинства типовых ситуаций на практике.