本文详解如何在 wordpress 中通过 jquery ajax 向 php 后端安全、可靠地传递 javascript 数组，解决 `$_post['data']` 返回 `null` 的常见问题，涵盖 json 序列化、请求方法、php 接收与解码的完整链路。
在 WordPress 插件或主题开发中，常需通过 Ajax 将前端收集的数组（如用户 ID 列表）提交至后端处理。但许多开发者会遇到 $_POST['data'] 或 $_REQUEST['data'] 为 null 的问题——这并非 WordPress 限制数组传输，而是因数据格式、传输方式与服务端解析不匹配所致。
核心问题在于：
✅ 前端必须明确使用 type: 'POST'（WordPress 的 wp_ajax_* 钩子默认仅响应 POST 请求）；
❌ 不应将已序列化的 JSON 字符串再次包裹为对象（如 'data': {data: jsonIDs}），否则 PHP 收到的是嵌套键名，而非原始字符串；
✅ 后端须使用 $_POST（非 $_REQUEST）并配合 json_decode() 正确还原数组；
✅ 必须调用 die() 或 wp_die() 终止执行，避免 WordPress 默认输出干扰 JSON 响应。
以下是经过验证的完整实现方案：
✅ 正确的 jQuery 代码：
var userIDs = [];
$("tr.user-row").each(function() {
var userID = $(this).attr("data-userid");
if (userID) userIDs.push(userID); // 防空校验
});
var jsonIDs = JSON.stringify(userIDs);
$.ajax({
type: 'POST', // 关键：显式声明 POST 方法
url: ajaxurl,
data: {
'action': 'built_ranking',
'data': jsonIDs // 直接传字符串，不要再套一层对象
},
dataType: 'json',
success: function(response) {
console.log('Success:', response);
// 示例：遍历返回的数组
// response.forEach(item => console.log(item));
},
error: function(xhr, status, error) {
console.error('Ajax Error:', error, xhr.responseText);
}
});✅ 正确的 PHP 后端处理（functions.php 或插件主文件）：
function built_ranking() {
// 1. 检查是否为 POST 请求且包含必要参数
if (!isset($_POST['data']) || !is_string($_POST['data'])) {
wp_send_json_error(['message' => 'Invalid or missing data']);
return;
}
// 2. 安全解码 JSON（stripslashes 防 magic quotes，现代环境通常可省略）
$decoded = json_decode(stripslashes($_POST['data']), true);
// 3. 验证解码结果是否为数组
if (json_last_error() !== JSON_ERROR_NONE || !is_array($decoded)) {
wp_send_json_error(['message' => 'Invalid JSON format']);
return;
}
// 4. 业务逻辑处理（例如查询数据库、计算排名等）
// $userPoints = calculate_ranking($decoded);
// 5. 返回结构化 JSON 响应（推荐使用 wp_send_json_* 系列函数）
wp_send_json_success($decoded); // 自动设置 header + json_encode + die()
}
add_action('wp_ajax_built_ranking', 'built_ranking');
// 如需前台访问，额外添加：
// add_action('wp_ajax_nopriv_built_ranking', 'built_ranking');? 关键注意事项：
- 永远使用 wp_send_json_success() / wp_send_json_error()：它们自动设置 Content-Type: application/json 头、执行 json_encode() 并调用 die()，比手动 echo + die 更安全可靠；
- 避免 $_REQUEST：它混合了 GET/POST/COOKIE，易受干扰；WordPress Ajax 规范要求使用 $_POST；
- 前端调试技巧：在 Ajax 前加 console.log(jsonIDs) 确认字符串格式；在 PHP 中临时加入 error_log(print_r($_POST, true)); 查看真实接收内容；
- 安全性补充：若数据涉及用户权限（如批量操作用户），务必在 PHP 中调用 current_user_can() 校验能力，并对 userIDs 做 absint() 或白名单过滤。
遵循以上模式，即可稳定实现前端数组 → WordPress Ajax → PHP 数组的端到端传递，彻底告别 null 困扰。
