PHP接收JSON数据实战教程

本文深入解析了PHP接收前端JSON数据的核心要点与常见陷阱，强调必须使用`file_get_contents('php://input')`手动读取原始请求体，因为当Content-Type为`application/json`时PHP不会自动解析到`$_POST`；同时详解了如何正确判断请求类型、避免重复读取、合理使用`json_decode($json, true)`获取数组、验证解码错误、排查乱码与空输入原因，并提醒注意Nginx/Apache配置、框架封装本质及调试中的真实请求体验证——帮你避开90%的JSON接收失败问题。

PHP 用 file_get_contents('php://input') 读原始 JSON

前端发来的 JSON 数据，如果 Content-Type 是 application/json，PHP 不会自动解析进 $_POST 或 $_REQUEST —— 它压根不处理，直接扔进输入流。这时候必须手动读原始体。

常见错误现象：$_POST 为空、json_decode($_POST) 报错、$_GET 里也找不到数据。

• file_get_contents('php://input') 是唯一可靠方式（注意：不能重复读，且 POST 方法下才有效）
• 别用 $HTTP_RAW_POST_DATA —— PHP 5.6+ 已废弃，7.0+ 彻底移除
• 如果用了框架（如 Laravel、ThinkPHP），它们通常封装了这一层，但底层仍是读 php://input
• 确保前端没把 JSON 塞进表单字段再提交（比如用 FormData + append('data', JSON.stringify(...))），那样就走 $_POST 了，但不是纯 JSON 请求

json_decode() 的第二个参数设为 true 才得数组

PHP 默认把 JSON 解成对象（stdClass），而多数人习惯用数组下标访问，不设参数就会踩坑：比如 $data->name 报错说属性不存在，其实是因为你传的是字符串但解成了对象，或反过来。

• 要数组：用 json_decode($raw, true)
• 要对象：用 json_decode($raw)（第二个参数默认 false）
• 解码失败时返回 null，务必检查：if (json_last_error() !== JSON_ERROR_NONE) { /* 处理错误 */ }
• 中文字符乱码？不是编码问题，是前端没发 UTF-8，或 JSON 本身含非法 Unicode 转义（如 \u0000），json_last_error_msg() 能定位

Content-Type 不对会导致 php://input 为空

哪怕前端发了 JSON 字符串，如果请求头没带 Content-Type: application/json，有些代理、CDN 或 Nginx 配置会拒绝透传原始体，或者 PHP 某些 SAPI（如 CGI 模式）会忽略它。

• 用浏览器 DevTools 的 Network → Headers 确认请求头含 Content-Type: application/json
• cURL 测试时加：-H "Content-Type: application/json" -d '{"name":"a"}'
• Nginx 下若用了 client_max_body_size 限制太小，大 JSON 会被截断，php://input 可能只读到一部分 —— 查 error_log 里有没有 413 错误
• Apache + mod_php 一般没问题；但 FastCGI 模式下，某些旧版 PHP-FPM 配置可能丢原始体，需确认 variables_order 和 enable_post_data_reading = On

别在 $_POST 存在时还硬读 php://input

有些前端用 application/x-www-form-urlencoded 提交 JSON 字符串（比如字段名 payload，值是 {"a":1}），这时 $_POST['payload'] 就是你要的字符串 —— 不该再去读 php://input，否则拿到的是整个表单编码后的原始体（如 payload=%7B%22a%22%3A1%7D），还得 URL 解码再 JSON 解析，多此一举还容易出错。

• 先判断请求类型：$_SERVER['CONTENT_TYPE'] === 'application/json'
• 再决定走哪条路径：JSON 直接读流，表单则从 $_POST 取字段
• 混合场景（比如同时有 JSON body 和 query 参数）很常见，$_GET 和 php://input 可并存，但别混淆来源
• 调试时加一句：error_log('CT: ' . $_SERVER['CONTENT_TYPE'] . ', INPUT LEN: ' . strlen(file_get_contents('php://input')));

最常被忽略的是：你以为前端发的是 JSON，其实开发者工具里看到的 “Preview” 是浏览器帮你格式化过的，真实请求体可能被中间件改写、被 Axios 默认加了额外字段、甚至被 Chrome 插件注入了 header —— 动手前先抓包看原始 request body 和 headers。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。