如何在 PHP 中接收并解析前端发送的原始 JSON 数据-php教程-PHP中文网

如何在 PHP 中接收并解析前端发送的原始 JSON 数据

本文详解如何通过 HTTP POST 请求向 PHP 页面发送原始 JSON 字符串，并在服务端正确读取、解码和使用该数据，涵盖 fetch/AJAX 调用方式、PHP 端 php://input 读取要点及常见错误规避。

本文详解如何通过 http post 请求向 php 页面发送原始 json 字符串，并在服务端正确读取、解码和使用该数据，涵盖 fetch/ajax 调用方式、php 端 `php://input` 读取要点及常见错误规避。

在 Web 开发中，前端常需将结构化数据（如从第三方 API 获取的原始 JSON）直接提交给 PHP 后端进行处理。与表单数据（application/x-www-form-urlencoded）或文件上传不同，发送原始 JSON 时必须使用 application/json 内容类型，且 PHP 不会自动将其解析到 $_POST 中——必须手动读取请求体。

✅ 正确的前端发送方式（JavaScript）

使用 fetch() 发送原始 JSON 字符串（注意：不是对象，而是已序列化的字符串）：

const rawJson = `{
  "0": {
    "name": "Powerball",
    "plays": [{
      "name": "Powerball",
      "draws": [{
        "date": "08/22/2022",
        "nextDrawDate": "08/24/2022",
        "nextDrawJackpot": 100000000,
        "numbers": [
          {"value": "12", "order": 1},
          {"value": "27", "order": 2},
          {"value": "34", "order": 3},
          {"value": "55", "order": 4},
          {"value": "67", "order": 5},
          {"value": "09", "order": 6, "specialBall": {"name": "Powerball"}},
          {"value": "2", "order": 7, "specialBall": {"name": "Power Play"}}
        ]
      }]
    }]
  }
}`;

fetch('getAPIData.php', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: rawJson // 直接传入字符串，无需 JSON.stringify() 再封装
})
.then(response => response.json())
.then(data => console.log('Success:', data))
.catch(error => console.error('Error:', error));

⚠️ 注意：rawJson 是一个合法的 JSON 字符串（以反引号包裹），若你手动生成，务必确保格式严格符合 JSON 规范（如双引号、无尾逗号、日期斜杠需转义或使用 ISO 格式）。

dmap-jsapi-skill
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载

✅ PHP 后端接收与解析（`getAPIData.php`）

PHP 无法通过 $_POST 获取 application/json 请求体，必须使用 php://input 流读取原始数据：

<?php header('Content-Type: application/json; charset=utf-8');

// 1. 读取原始请求体（仅适用于 POST、PUT、PATCH 等有 body 的方法）
$rawInput = file_get_contents('php://input');

// 2. 验证输入是否为空
if (empty($rawInput)) {
    http_response_code(400);
    echo json_encode(['error' => 'No JSON data received']);
    exit;
}

// 3. 解析 JSON —— 第二个参数为 false 表示返回关联数组，true 表示返回对象（默认）
$data = json_decode($rawInput, true);

// 4. 检查解析是否成功
if (json_last_error() !== JSON_ERROR_NONE) {
    http_response_code(400);
    echo json_encode([
        'error' => 'Invalid JSON format',
        'details' => json_last_error_msg()
    ]);
    exit;
}

// 5. 安全访问嵌套数据（示例：提取第一个 lottery 的名称和首个开奖号码）
$lotteryKey = '0';
if (isset($data[$lotteryKey]['name'])) {
    $name = $data[$lotteryKey]['name'];
    $firstDraw = $data[$lotteryKey]['plays'][0]['draws'][0] ?? [];
    $firstNumber = $firstDraw['numbers'][0]['value'] ?? 'N/A';

    echo json_encode([
        'success' => true,
        'message' => "Received {$name}, first number: {$firstNumber}",
        'parsed_data' => $data
    ], JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
} else {
    echo json_encode(['error' => 'Unexpected JSON structure'], JSON_UNESCAPED_UNICODE);
}

? 关键注意事项

不要依赖 $_POST：application/json 请求不会填充 $_POST，该超全局变量仅用于 x-www-form-urlencoded 或 multipart/form-data。
php://input 只能读一次：它是只读流，多次调用 file_get_contents('php://input') 将返回空字符串。

CORS 问题：若前端与 PHP 不同源，需在 PHP 中添加响应头：

header('Access-Control-Allow-Origin: *');
header('Access-Control-Allow-Methods: POST, OPTIONS');
header('Access-Control-Allow-Headers: Content-Type');
if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') { exit(0); }

JSON 编码兼容性：建议始终使用 json_encode(..., JSON_UNESCAPED_UNICODE) 避免中文被转义为 \uXXXX。
生产环境校验：实际项目中应增加签名验证、请求来源限制、JSON 深度/大小限制（如 ini_set('max_input_vars', 5000)）等安全措施。