函数描述

中止 WordPress 执行并根据情况返回 HTML 错误信息。

此函数是对 PHP die() 函数的一个扩展补充，不同之处在于此函数可以在典型的 Web 请求中显示 HTML 信息给用户。建议只在函数有更多后续执行的时候使用此函数，不建议经常调用此函数。尽量试着静默地处理错误信息。

如果你确实需要停止并退出PHP脚本而不输出任何内容（同时让响应超时），使用 exit;,  die() 的更新版本， wp_die() 函数被设计用来在die()之前输出内容以防止空响应或超时响应。

使用方法

<?php wp_die( $message, $title, $args ) ?>

参数

$message

(
mixed) (
可选) 错误信息或一个完整的  WP_Error 对象。

默认:
None

$title

(
string) (可选) 错误标题，如果你使用了一个  WP_Error 对象，此标题默认添加到  $data['title'] ( DOING_AJAX 为 true 时忽略 ).

默认: ”

$args

(
string|array) (可选) 控制函数行为的可选参数 ( DOING_AJAX 为 true 时忽略 )。

默认:
None

$args 参数

response

(
integer) (可选) 返回的HTML状态码。

默认: 500

back_link

(
boolean) (可选) 是否在返回的页面中显示返回链接。

默认: false

text_direction

(
string) (可选)  文字书写方向是 ltr 或 rtl。

默认: ‘ltr’

返回值

(void)

此函数没有返回值

使用示例

查看一个filter中 $post 变量的内容。

add_filter( 'body_class', 'add_body_class_cb' );
// Testing what is in the $post variable.
function add_body_class_cb( $classes ) {
    global $post;

    wp_die( '<pre>' . var_export( $post, true ) . '</pre>' );
}