WordPress函数:wp_die 增强版的 PHP die函数

追格官方小助手/ 2023年02月01日/ WordPress/ 浏览 2460

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 )


发表评论

暂无评论,抢个沙发...

客服 工单