AJAX POST请求中JSON数据处理指南：PHP后端正确解析策略

window.addEventListener("DOMContentLoaded", (event) => {
    // 实例化 XMLHttpRequest 对象
    var xhr = new XMLHttpRequest();
    // 配置请求方法、URL和是否异步
    xhr.open('POST', 'src/ajax.php', true);
    // 设置请求头，告知服务器发送的数据是JSON格式
    xhr.setRequestHeader("Content-Type", "application/json");

    // 监听请求状态变化
    xhr.onreadystatechange = function () {
        // 当请求完成且成功时
        if (xhr.readyState === 4 && xhr.status === 200) {
            try {
                // 解析服务器返回的JSON响应
                var response = JSON.parse(xhr.responseText);
                console.log("服务器响应:", response);
            } catch (e) {
                console.error("解析服务器响应失败:", e);
            }
        } else if (xhr.readyState === 4 && xhr.status !== 200) {
            console.error("请求失败，状态码:", xhr.status);
        }
    };

    // 准备要发送的数据对象
    var dataToSend = {
        key1: "value1",
        key2: 123,
        nested: {
            item: "nested_item"
        }
    };

    // 将数据对象转换为JSON字符串并发送
    xhr.send(JSON.stringify(dataToSend));
});

<?php
header('Content-Type: application/json'); // 告知客户端响应是JSON格式

// 1. 获取原始POST请求体
$jsonString = file_get_contents('php://input');

// 2. 尝试将JSON字符串解码为PHP数组
// 第二个参数为 true 表示解码为关联数组，默认为对象
$data = json_decode($jsonString, true);

// 3. 检查JSON解码是否成功
if (json_last_error() !== JSON_ERROR_NONE) {
    // JSON解析失败，返回错误信息
    http_response_code(400); // Bad Request
    echo json_encode([
        'status' => 'error',
        'message' => 'Invalid JSON received.',
        'json_error' => json_last_error_msg()
    ]);
    exit();
}

// 4. 检查是否成功获取到数据（例如，数据是否为空）
if (empty($data)) {
    http_response_code(400); // Bad Request
    echo json_encode([
        'status' => 'error',
        'message' => 'No data received or data is empty.'
    ]);
    exit();
}

// 5. 成功解析数据，可以根据需要处理数据
// 假设客户端发送的数据结构是 { key1: "...", key2: "..." }
$key1Value = isset($data['key1']) ? $data['key1'] : null;
$key2Value = isset($data['key2']) ? $data['key2'] : null;
$nestedItem = isset($data['nested']['item']) ? $data['nested']['item'] : null;


// 6. 返回一个JSON格式的响应
echo json_encode([
    'status' => 'success',
    'message' => 'Data received and processed successfully!',
    'received_data' => $data, // 返回接收到的原始数据
    'extracted_key1' => $key1Value,
    'extracted_key2' => $key2Value,
    'extracted_nested_item' => $nestedItem
]);

// 示例：如果客户端发送的是 { data: "test" }
// 那么 $data['data'] 将是 "test"
// echo json_encode(['received_data_field' => $data['data']]);
?>