Описание функции wp_send_json()
Функция wp_send_json() используется для отправки JSON-данных в ответ на AJAX-запросы. Она автоматически устанавливает заголовок Content-Type в application/json и завершает выполнение скрипта после отправки данных. Это упрощает процесс работы с AJAX в WordPress, обеспечивая корректную сериализацию данных и завершение обработки.
Параметры
$data
Тип: mixed
Обязательный: Да
По умолчанию: null
Описание: Данные, которые будут отправлены в формате JSON
Возможные значения:
Возвращаемое значение
Тип: void
Описание: Отправляет JSON-данные и завершает выполнение скрипта
Возможные значения:
• JSON-ответ с данными
• Завершение обработки скрипта
Примеры использования
Отправка простого JSON-ответа
$data = array('success' => true, 'message' => 'Данные успешно обработаны');
wp_send_json($data);
Ответ будет {‘success’: true, ‘message’: ‘Данные успешно обработаны’}
Отправка JSON-ответа в случае ошибки
$error = array('error' => 'Произошла ошибка');
wp_send_json($error);
Ответ будет {‘error’: ‘Произошла ошибка’}
Безопасность
Валидация входных данных: Данные сериализуются перед отправкой
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: Убедитесь, что данные, отправляемые пользователю, безопасны и не содержат конфиденциальной информации
— Связанные функции
Отправляет успешный JSON-ответ с данными
Отправляет ошибочный JSON-ответ
— Примечания
– Ограничения
Функция завершает выполнение скрипта, дополнительные выводы после вызова не будут обработаны
– Частые проблемы
- Неправильный формат данных может привести к ошибкам сериализации
- Не забывайте вызывать функцию только в контексте AJAX
