wp_die 中止程序执行并返回错误信息

函数描述 中止 WordPress 执行并根据情况返回 HTML 错误信息。 此函数是对 PHP die() …

函数描述

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

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

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

使用方法

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

参数

参数 数据类型 是否必需 描述 默认值
$message 多种 错误信息或一个 WP_Error 对象
$title 字符串 错误标题,如果你使用了一个 WP_Error 对象,此标题默认添加到 $data[‘title’] ( DOING_AJAX 为 true 时忽略 )
$args 字符串|数组 控制函数行为的可选参数 ( 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>' );
}
类别:WordPress函数讲解

本文收集自互联网,转载请注明来源。
如有侵权,请联系 wper_net@163.com 删除。

评论 (0)COMMENT

登录 账号发表你的看法,还没有账号?立即免费 注册