wp_die 是 WordPress 中对 PHP die 函数的增加函数,可以完全替代 die。
如果,仅仅把 wp_die 当做 die 函数的替代函数,绝对是小看这个函数了。
函数原型:
wp_die( string|WP_Error $message = '', string|int $title = '', string|array|int $args = array() )
首先,和 die 函数不同的是,wp_die 展示的是 HTML。
参数说明:
$message string 或 WP_Error
错误消息。如果这是 WP_Error 对象,而不是 Ajax 或 XML-RPC 请求,则使用 WP_Error 的错误消息。
$title string 或 int
错误标题。如果 $message 是 WP_Error 对象,则可以使用键为“title”的错误数据来指定标题。如果$title是整数,则将其视为响应代码。
$args string 或 array 或 int
控制行为的参数。如果$args是整数,则将其视为响应代码。
response int
HTTP响应代码。Ajax请求默认为200,否则为500。
link_url string
包含链接的URL。仅与$link_text结合使用。 默认空字符串。
link_text string
要包含的链接的标签。仅与$link_url结合使用。默认空字符串。
back_link bool
是否包含要返回的链接。默认值为false。
text_direction string
文本方向。这只在内部有用,当WordPress仍在加载并且站点的区域设置尚未设置时。接受“rtl”和“ltr”。默认值为is_rtl()的值。
charset string
HTML输出的字符集。默认值“utf-8”。
code string
要使用的错误代码。默认值为“wp_die”,如果$message是wp_error,则为主要错误代码。
exit bool
完成后是否退出流程。默认为true。
丰富的参数,必然有丰富的功能。还不止如此,wp_die 还支持一堆钩子,可以方便对各种异常情况个性化处理。
// Ajax 请求
apply_filters( 'wp_die_ajax_handler', callable $callback )
// non-Ajax, non-JSON, non-XML 请求
apply_filters( 'wp_die_handler', callable $callback )
// JSONP REST 请求
apply_filters( 'wp_die_jsonp_handler', callable $callback )
// JSON 请求
apply_filters( 'wp_die_json_handler', callable $callback )
// XML-RPC 请求
apply_filters( 'wp_die_xmlrpc_handler', callable $callback )
// XML 请求
apply_filters( 'wp_die_xml_handler', callable $callback )
-
WordPress函数:number_format_i18n 数字国际化WordPress函数:number_format_i18n 数字国际化
-
WordPress函数:date_i18n 日期国际化WordPress函数:date_i18n 日期国际化
-
WordPress函数:esc_html_e 转义翻译的字符串并显示WordPress函数:esc_html_e 转义翻译的字符串并显示
-
WordPress函数:esc_attr_e 属性转义、翻译、显示WordPress函数:esc_attr_e 属性转义、翻译、显示
-
WordPress函数:esc_attr_x 带上下文的转义属性,翻译显示WordPress函数:esc_attr_x 带上下文的转义属性,翻译显示
-
WordPress必备:使用wp_get_theme()函数获取当前主题详情在WordPress中,wp_get_theme() 函数用于获取当前启用的主题或指定主题的信息。这个函数返回一个 WP_Theme 对象,该对象包含了主题的详细信息,如主题名称、版本、模板目录、样式表目录等。
暂无评论,抢个沙发...