WordPress функция wp_die() дополняет PHP-функцию die(). Отличие заключается в том, что пользователю будет отображен HTML. Рекомендуется использовать эту функцию только тогда, когда выполнение скрипта не должно продолжаться дальше. Не рекомендуется вызывать эту функцию слишком часто, а стараться обрабатывать как можно больше ошибок незаметно или более элегантно.
Возвращает
Функция ничего не возвращает, а обрывает работу PHP.
wp_die( $message, $title, $args );
Параметры
$message: Текст ошибки (может содержать HTML). Если передать объект WP_Error, то функция возьмет сообщение об ошибке из него. Сообщение будет обернуто в с классом wp-die-message.
$title: Заголовок страницы (отображается в <title>). Если в $message передан WP_Error и этот параметр не строка, то заголовок берется из объекта WP_Error (если он там есть). Числовой код ошибки в этом параметре игнорируется.
По умолчанию заголовок «WordPress › Ошибка».
$args: Массив дополнительных параметров (настроек)
$args = array( 'response' => 500, 'code' => 'wp_die', 'exit' => true, 'back_link' => false, 'link_url' => '', 'link_text' => '', 'text_direction' => '', 'charset' => 'utf-8', 'additional_errors' => array(), );
Дополнительные параметры в массиве $args:
response: Код ответа сервера (целое число). По умолчанию 500.
code: Код ошибки (строка). Используется только в REST API. По умолчанию “wp_die” или берется из объекта WP_Error.
exit: Прерывать выполнение кода функцией die() (логическое). По умолчанию true. Можно установить в false, чтобы код не прерывался.
back_link: Добавить ссылку “Back” на предыдущую страницу (логическое). Автоматически переводится.
link_url: URL ссылки, добавляемой после сообщения об ошибке (строка).
link_text: Текст ссылки, добавляемой после сообщения об ошибке (строка). Обязателен вместе с link_url.
text_direction: Направление текста (“rtl” для справа налево) (строка).
charset: Кодировка страницы (строка).
additional_errors: Массив дополнительных ошибок. Каждая ошибка — массив с ключом message (текст ошибки). Все ошибки (включая основную) выводятся как маркированный список.
Примеры
<div class="wp-block-misha-code"> <div class="synt"> <div class="code"> <pre class="php">wp_die( 'Тут можно написать любое название ошибки' );</pre> </div> </div> </div> </div>