本文旨在解决如何在 WordPress 中将 PHP 变量的值嵌入到 JSON 响应中的问题。通过 wp_send_json_success() 和 wp_send_json_error() 函数，你可以轻松地构建成功的或错误的 JSON 响应。此外，本文还展示了如何使用 AJAX 发送数据并在前端接收和处理 JSON 响应，从而实现动态的数据交互。
在 WordPress 中，将 PHP 变量传递到 JSON 文件通常涉及生成一个包含变量值的 JSON 响应，并将其发送到客户端。WordPress 提供了便捷的函数来处理 JSON 响应，以及通过 AJAX 进行数据交互。
使用 wp_send_json_success() 和 wp_send_json_error()
WordPress 提供了 wp_send_json_success() 和 wp_send_json_error() 函数，用于发送包含成功或错误信息的 JSON 响应。这两个函数简化了构建 JSON 响应的过程，并自动设置正确的 HTTP 头部。
立即学习“PHP免费学习笔记（深入）”；
- wp_send_json_success( $data = null ): 发送一个成功的 JSON 响应。$data 参数可以是一个数组、对象或字符串，将被编码为 JSON 并发送到客户端。
- wp_send_json_error( $data = null ): 发送一个错误的 JSON 响应。$data 参数与 wp_send_json_success() 类似，用于传递错误信息。
示例：
<?php
// 假设 $hatus 是你想要传递的 PHP 变量
$hatus = 'Hello, JSON!';
// 构建包含 $hatus 值的数组
$response_data = array(
'message' => 'Variable value:',
'hatus_value' => $hatus
);
// 发送成功的 JSON 响应
wp_send_json_success( $response_data );
// 如果发生错误，可以发送错误响应
// wp_send_json_error( 'An error occurred.' );
?>注意事项：
- 在使用 wp_send_json_success() 或 wp_send_json_error() 之前，确保没有输出任何其他内容（例如 HTML 或文本）。 否则，JSON 响应可能无法正确解析。
- 这两个函数会自动调用 die()，因此在调用它们之后，脚本将停止执行。
通过 AJAX 发送和接收 JSON 数据
为了在前端使用 JSON 响应，通常需要使用 AJAX 从服务器请求数据。以下是一个使用 jQuery AJAX 请求数据的示例：
jQuery(document).ready(function($) {
$.ajax({
url: ajaxurl, // WordPress 定义的 AJAX URL
type: 'POST',
data: {
action: 'my_ajax_action', // 用于识别 AJAX 请求的 action
hatus_value: 'Some value to send' // 可选：向服务器发送数据
},
success: function(response) {
// 处理成功的响应
if (response.success) {
alert(response.data.message + ' ' + response.data.hatus_value);
} else {
alert('Error: ' + response.data);
}
},
error: function(error) {
// 处理错误
console.error('AJAX error:', error);
}
});
});服务器端代码 (functions.php 或自定义插件):
<?php
add_action( 'wp_ajax_my_ajax_action', 'my_ajax_callback' );
add_action( 'wp_ajax_nopriv_my_ajax_action', 'my_ajax_callback' ); // 如果允许未登录用户访问
function my_ajax_callback() {
// 获取通过 AJAX 传递的数据
$hatus_value = $_POST['hatus_value'];
// 执行一些操作，例如从数据库中检索数据
$data = array(
'message' => 'Received data:',
'hatus_value' => $hatus_value
);
// 发送 JSON 响应
wp_send_json_success( $data );
// 或者，如果发生错误
// wp_send_json_error( 'An error occurred.' );
wp_die(); // 始终在 AJAX 回调函数中调用 wp_die()
}
?>步骤解释：
- 前端 AJAX 请求: 使用 jQuery 的 $.ajax() 函数发送一个 POST 请求到 WordPress 的 ajaxurl。data 对象包含 action 参数，用于指定要调用的服务器端函数，以及其他需要传递的数据。
- 服务器端处理: 在 functions.php 文件或自定义插件中，使用 add_action() 函数注册 AJAX 回调函数。wp_ajax_{action} 针对已登录用户，wp_ajax_nopriv_{action} 针对未登录用户。
- 回调函数: 回调函数（例如 my_ajax_callback()）接收来自 AJAX 请求的数据，执行必要的操作，并使用 wp_send_json_success() 或 wp_send_json_error() 发送 JSON 响应。
- 处理响应: 在前端的 success 回调函数中，处理来自服务器的 JSON 响应。可以使用 response.data 访问响应数据，并根据 response.success 的值判断请求是否成功。
总结
通过使用 wp_send_json_success() 和 wp_send_json_error() 函数，你可以轻松地在 WordPress 中构建和发送 JSON 响应。结合 AJAX 技术，可以实现前后端的数据交互，从而构建动态的 WordPress 应用。务必注意在发送 JSON 响应之前不要输出任何其他内容，并在 AJAX 回调函数中调用 wp_die()，以确保响应的正确性。
