WordPress функция wp_send_json_error()

Если вы разрабатываете плагины или темы для WordPress, вам, вероятно, придется работать с AJAX-запросами. В таких случаях важно знать, как правильно обрабатывать ошибки и возвращать соответствующие ответы. В этой статье мы рассмотрим, как использовать функцию wp_send_json_error() в WordPress, чтобы отправлять JSON-ответы с ошибками.

Что такое wp_send_json_error()?

wp_send_json_error() — это встроенная функция в WordPress, которая используется для отправки JSON-ответа с ошибкой. Эта функция упрощает процесс обработки ошибок в AJAX-запросах, позволяя разработчикам легко возвращать сообщения об ошибках клиенту.

Основные особенности

• Отправка JSON-ответа: Функция отправляет JSON-ответ с кодом ошибки и сообщением.
• Упрощение обработки ошибок: Позволяет легко обрабатывать ошибки в AJAX-запросах.
• Поддержка дополнительных данных: Можно передавать дополнительные данные вместе с сообщением об ошибке.
• Упрощение кода: Функция упрощает процесс отправки JSON-ответов с ошибками, уменьшая количество кода, необходимого для обработки ошибок.
• Стандартизация: Использование стандартных функций WordPress помогает поддерживать единый стиль кода в проекте.
• Поддержка дополнительных данных: Возможность передавать дополнительные данные вместе с сообщением об ошибке позволяет более точно информировать клиента о произошедшей ошибке.

Синтаксис функции

wp_send_json_error( $data, $status_code );

function my_ajax_handler() {
    // Проверка на ошибку
    if ( ! isset( $_POST['my_data'] ) ) {
        wp_send_json_error( array(
            'message' => 'Ошибка: данные не переданы.',
            'code' => 'missing_data'
        ) );
    }

    // Обработка данных
    $data = sanitize_text_field( $_POST['my_data'] );

    // Возврат успешного ответа
    wp_send_json_success( $data );
}

add_action( 'wp_ajax_my_ajax_action', 'my_ajax_handler' );
add_action( 'wp_ajax_nopriv_my_ajax_action', 'my_ajax_handler' );