小程序POST请求PHP收不到$_POST数据是因为默认content-type为application/json,PHP仅自动解析x-www-form-urlencoded和multipart/form-data;需用file_get_contents('php://input')读取并json_decode解析。

小程序调用 wx.request 发起的 POST 请求,PHP 后端默认收不到 $_POST 数据——这不是 PHP 的问题,而是微信小程序默认以 application/json 格式发送请求体,而 PHP 只自动解析 application/x-www-form-urlencoded 和 multipart/form-data 两类请求体。
PHP 无法获取 $_POST 是因为请求体是 JSON
小程序代码中若这样写:
wx.request({
url: 'https://yourdomain.com/api/login.php',
method: 'POST',
data: { username: 'admin', password: '123' },
header: { 'content-type': 'application/json' }
});
此时 PHP 的 $_POST 为空数组,因为:
-
application/json请求体不会被 PHP 自动解析进$_POST - 原始数据全部在
php://input流中,需手动读取并解码 - 若小程序没显式设置
header,wx.request默认使用application/json(注意:基础库 2.10.4+ 默认行为)
PHP 正确接收小程序 JSON 请求的写法
在 api/login.php 中按以下步骤处理:
立即学习“PHP免费学习笔记(深入)”;
- 先用
file_get_contents('php://input')读取原始请求体 - 用
json_decode()解析为 PHP 数组或对象(推荐true参数转数组) - 检查是否解析成功,避免空值或格式错误导致后续逻辑崩溃
$raw = file_get_contents('php://input');
$data = json_decode($raw, true);
if (json_last_error() !== JSON_ERROR_NONE) {
http_response_code(400);
echo json_encode(['error' => 'Invalid JSON']);
exit;
}
$username = $data['username'] ?? '';
$password = $data['password'] ?? '';
想用 $_POST?小程序必须改 content-type
如果坚持用 $_POST,小程序端需显式改成表单编码,并确保 data 是普通对象(非 JSON 字符串):
wx.request({
url: 'https://yourdomain.com/api/login.php',
method: 'POST',
data: { username: 'admin', password: '123' },
header: { 'content-type': 'application/x-www-form-urlencoded' }
});
此时 PHP 才能直接用 $_POST['username']。但要注意:
- 小程序会自动将
data对象 URL 编码,不支持嵌套对象或数组(如{ user: { name: 'a' } }会被扁平化或丢失) - 文件上传、复杂结构数据必须走
application/json+php://input - 部分云开发或代理网关可能重写 header,导致实际 content-type 与预期不符
调试时最容易忽略的两个点
很多 PHP 接口看似“收不到数据”,其实卡在这两处:
- 没检查小程序控制台 Network 面板里真实发出的
Content-Type和 Request Payload 内容(不是看代码写的,是看实际发的) - PHP 文件开头有空白字符或 BOM 头,导致
json_decode解析失败却没报错(json_last_error()返回JSON_ERROR_SYNTAX,但常被忽略)
建议所有接收 JSON 的 PHP 入口第一行加 if (isset($_SERVER['CONTENT_TYPE']) && strpos($_SERVER['CONTENT_TYPE'], 'application/json') !== false) { ... } 显式判断,再决定走哪条解析路径。











