PHP中处理JSON POST请求：$_POST为空的解决方案与实践

当通过post请求发送`application/json`数据时，php的`$_post`超全局变量会保持为空。这是因为`$_post`专用于解析`application/x-www-form-urlencoded`或`multipart/form-data`类型的数据。要正确获取并处理json格式的请求体，开发者应使用`file_get_contents('php://input')`读取原始请求流，再结合`json_decode()`将其转换为php数组或对象。本文将详细介绍这一机制及具体实现方法。

引言：理解HTTP POST请求与数据类型

HTTP POST请求是客户端向服务器提交数据的主要方式。在Web开发中，我们通常会遇到两种常见的数据提交格式：

1. application/x-www-form-urlencoded: 这是HTML表单默认的提交方式。数据以键值对的形式编码，例如key1=value1&key2=value2。PHP会自动解析这类数据，并填充到$_POST超全局变量中。
2. application/json: 随着前后端分离和API开发的普及，JSON格式的数据传输变得越来越流行。它以结构化的方式表示数据，例如{"key1": "value1", "key2": "value2"}。

当客户端使用Content-Type: application/json发送数据时，PHP的$_POST变量会保持为空。这是因为PHP的内置解析器不会自动解析JSON格式的请求体并填充到$_POST中。因此，需要手动从原始请求流中读取数据。

核心解决方案：通过php://input获取原始请求体

PHP提供了一个特殊的只读流——php://input，它允许开发者访问HTTP请求的原始数据。对于application/json类型的POST请求，完整的JSON数据就存在于这个流中。

要获取这些数据，可以使用file_get_contents()函数读取php://input流的内容。读取到的将是一个JSON格式的字符串。获取到JSON字符串后，需要使用json_decode()函数将其转换为PHP可以操作的数组或对象。

立即学习“PHP免费学习笔记（深入）”；

实战示例

假设我们有一个PHP脚本api/v1/customers，用于接收JSON数据。

PHP脚本 (api/v1/customers):

标签： php html js json php函数 apache nginx 编码 app 后端 curl ai sql注入