Как удалить PHP ошибки в WordPress: практические советы и примеры

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

Почему возникают PHP ошибки в WordPress

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

Основные типы PHP ошибок:

• Parse error (синтаксическая ошибка) — ошибка в структуре кода;
• Fatal error (фатальная ошибка) — прекращение выполнения скрипта;
• Warning (предупреждение) — ошибки, не останавливающие выполнение, но важные для исправления;
• Notice (замечание) — уведомления о потенциальных проблемах.

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

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

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

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

Объяснение:

• WP_DEBUG — включает режим отладки;
• WP_DEBUG_LOG — сохраняет ошибки в файл wp-content/debug.log;
• WP_DEBUG_DISPLAY — показывает ошибки на экране;
• ini_set('display_errors', 1) — дополнительно включает отображение ошибок на уровне PHP.

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

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

Существует несколько полезных плагинов, которые помогут упростить поиск и анализ ошибок.

Query Monitor

Очень мощный плагин, который показывает не только PHP ошибки, но и запросы к базе, хуки, HTTP-запросы и многое другое. После установки в админ-панели появится панель с подробной информацией о текущем запросе.

Преимущества:

• Отображает все ошибки и предупреждения PHP;
• Помогает выявить проблемные запросы к базе данных;
• Легко фильтруется и настраивается.

Debug Bar

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

Как самостоятельно фиксировать PHP ошибки — примеры кода

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

function wpstandart_log_php_error($errno, $errstr, $errfile, $errline) {
    $log = date('Y-m-d H:i:s') . " - Error [$errno]: $errstr in $errfile on line $errline\n";
    error_log($log, 3, WP_CONTENT_DIR . '/php-error.log');
    /* Можно добавить дополнительные действия, например, отправку уведомления */
    return false; // Передать обработку PHP дальше
}
set_error_handler('wpstandart_log_php_error');

Этот код нужно разместить в файле functions.php вашей темы или в собственном плагине. Он перехватывает все ошибки PHP и записывает их в файл wp-content/php-error.log. Это удобно для анализа ошибок на живом сайте без отображения их пользователям.

Обработка фатальных ошибок через shutdown-функцию

Фатальные ошибки PHP не всегда можно обработать стандартным обработчиком ошибок. Для этого используется функция, регистрируемая через register_shutdown_function:

function wpstandart_fatal_error_handler() {
    $error = error_get_last();
    if ($error && ($error['type'] & (E_ERROR | E_CORE_ERROR | E_COMPILE_ERROR | E_USER_ERROR))) {
        $log = date('Y-m-d H:i:s') . " - Fatal Error: {$error['message']} in {$error['file']} on line {$error['line']}\n";
        error_log($log, 3, WP_CONTENT_DIR . '/php-error.log');
        // Здесь можно добавить уведомление администратору
    }
}
register_shutdown_function('wpstandart_fatal_error_handler');

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

Советы по профилактике и устранению PHP ошибок

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

Часто ошибки возникают из-за устаревших компонентов. Обновляйте плагины и темы своевременно, проверяйте совместимость с текущей версией WordPress и PHP.

Использование локального окружения для тестирования

Перед установкой новых плагинов или изменением кода тестируйте их в локальной копии сайта или на отдельном тестовом сервере. Это позволит избежать ошибок на живом сайте.

Изоляция проблемных плагинов

Если появилась ошибка, попробуйте отключать плагины по одному, чтобы выявить источник проблемы. Для этого можно воспользоваться плагином Health Check, который позволяет отключать плагины только для текущего пользователя.

Заключение

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