PHP如何接收百度小程序数据详解

百度小程序与PHP后端对接看似简单，实则暗藏三大关键陷阱：JSON请求体不会自动填充$_POST，必须用php://input手动读取并解析；文件上传必须走swan.uploadFile且目标域名需在百度后台严格白名单配置；swan.login获取的code换取session_key时，PHP必须通过HTTPS GET方式调用百度开放平台接口，不可用POST或HTTP。本文直击开发中最常踩坑的底层协议细节，帮你避开“请求收不到”“上传失败”“登录凭证无效”等典型问题，真正打通从小程序到PHP服务的数据链路。

百度小程序的 swan.request 默认发送的是 JSON 数据，PHP 需主动读取原始 body

百度小程序调用 swan.request 时，若未显式设置 header['Content-Type']，默认会以 application/json 发送。此时 PHP 不会自动解析到 $_POST，必须用 file_get_contents('php://input') 手动读取原始请求体。

• 直接访问 $_POST 会为空数组，这是最常见踩坑点
• 如果前端设置了 header: {'Content-Type': 'application/x-www-form-urlencoded'}，PHP 才会填充 $_POST
• 推荐统一走 JSON 路线，语义清晰、支持嵌套结构，后端解析也更可控

if ($_SERVER['CONTENT_TYPE'] === 'application/json') {
    $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;
    }
} else {
    $data = $_POST;
}

百度小程序调用需携带 swan.getSystemInfo 中的 platform 和 version 字段做基础校验

虽然百度未强制要求接口鉴权，但生产环境建议对请求来源做轻量识别，避免被恶意模拟。可从 swan.getSystemInfo 获取设备信息，随请求一起传入，PHP 端简单校验是否为合法的小程序平台。

• 前端示例：swan.getSystemInfo({success: res => swan.request({data: {...res, ...myData}})})
• PHP 中检查 $data['platform'] === 'swan'，并可选校验 $data['version'] 是否符合最低支持版本
• 注意：不要依赖 userAgent 做判断，百度小程序 WebView 的 UA 可能被覆盖或不可靠

接收文件上传要用 swan.uploadFile，PHP 处理逻辑和普通表单一致，但路径需适配百度域名白名单

百度小程序上传文件必须使用 swan.uploadFile，且目标 URL 必须在百度后台配置的「request 合法域名」和「uploadFile 合法域名」中，否则前端直接报错 fail abort 或 fail url not in domain list。

• PHP 接收时，文件信息在 $_FILES 中，和普通 HTML 表单无异
• 务必检查 $_FILES['file']['error'] === UPLOAD_ERR_OK，再处理临时文件
• 百度小程序不支持多文件同 key 上传（如 name="file[]"），一次只能传一个 filePath

$file = $_FILES['file'] ?? null;
if (!$file || $file['error'] !== UPLOAD_ERR_OK) {
    http_response_code(400);
    echo json_encode(['error' => 'Upload failed']);
    exit;
}
$ext = pathinfo($file['name'], PATHINFO_EXTENSION);
$target = '/path/to/upload/' . uniqid() . '.' . strtolower($ext);
if (move_uploaded_file($file['tmp_name'], $target)) {
    echo json_encode(['url' => 'https://yourdomain.com/' . basename($target)]);
}

百度小程序的 swan.login code 换取 session_key 需调用百度开放平台接口，PHP 必须用 https + GET 请求

前端调用 swan.login 获取 code 后，需由 PHP 向百度开放平台发起请求换取用户凭证，地址是 https://openapi.baidu.com/rest/2.0/smartapp/user/login，参数必须用 GET 传，不能 POST。

• 必填参数：code、grant_type=authorization_code、client_id（即百度小程序 AppKey）、client_secret
• 返回 JSON 包含 session_key 和 openid，可用于后续解密手机号等敏感数据
• 百度该接口不支持 HTTP，强制 HTTPS；且不接受 Content-Type: application/json，只认 query string

$url = 'https://openapi.baidu.com/rest/2.0/smartapp/user/login?' . http_build_query([
    'code' => $code,
    'grant_type' => 'authorization_code',
    'client_id' => 'your_app_key',
    'client_secret' => 'your_app_secret'
]);
$response = file_get_contents($url);
$result = json_decode($response, true);

百度小程序对接 PHP 的关键不在“怎么写”，而在于清楚每个环节的数据流向和协议约束——尤其是 JSON 请求体不进 $_POST、文件上传域名白名单、登录换 token 必须 GET 这三点，漏掉任一都卡死在第一步。

理论要掌握，实操不能落！以上关于《PHP如何接收百度小程序数据详解》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！