钩子文档

wp_die_json_handler

💡 云策文档标注

概述

wp_die_json_handler 是一个 WordPress 过滤器,用于自定义 JSON 请求中终止执行时的回调函数。它允许开发者替换默认的 JSON 错误处理程序。

关键要点

  • 过滤器名称:wp_die_json_handler
  • 默认回调:_json_wp_die_handler
  • 参数:$callback,必须是可调用的函数名
  • 用途:在 JSON 请求中,当 wp_die() 被调用时,控制错误响应的处理方式
  • 引入版本:WordPress 5.1.0

代码示例

$callback = apply_filters( 'wp_die_json_handler', '_json_wp_die_handler' );

注意事项

此过滤器仅影响 JSON 请求;对于非 JSON 请求,wp_die() 使用其他处理程序。确保回调函数能正确处理 JSON 格式的错误输出。


📄 原文内容

Filters the callback for killing WordPress execution for JSON requests.

Parameters

$callbackcallable
Callback function name.

Source

$callback = apply_filters( 'wp_die_json_handler', '_json_wp_die_handler' );

Changelog

Version Description
5.1.0 Introduced.