如何使用 cURL 正确发送 JSON 数据到 PHP REST 接口

如何使用 cURL 正确发送 JSON 数据到 PHP REST 接口

本文详解如何通过 curlphp 后端(如 `rest_searchresult.php`)以 post 方式提交标准 json 格式请求,重点解决字段拼写错误、content-type 设置、请求体构造及 cookie 处理等常见陷阱。

在调用类似 https://pflegefinder.bkk-dachverband.de/aua/rest_searchresult.php 这类基于 JSON 的 REST 接口时,必须确保请求完全符合服务端预期的格式与语义。从原始代码可见,问题根源并非 cURL 配置本身,而是两个关键失误:

  1. 字段名拼写错误:”laguage” → 应为 “language”(原文中未显式写出但上下文暗示存在该错别字,且答案明确指出此为 SQL 报错主因);
  2. JSON 请求体构造不当:使用 urlencode(json_encode(…)) 并作为表单字段传入(array(“searchdata”=>$data_string)),导致服务端收到的是 URL 编码后的字符串而非原始 JSON,且未正确嵌套 searchdata 对象结构。

✅ 正确做法是:直接将结构化 JSON 字符串作为 CURLOPT_POSTFIELDS 的值,并显式声明 Content-Type: application/json

以下为可直接运行的完整示例(已修复字段名、精简配置、增强健壮性):

 [
        "required"     => 1,
        "statistics"   => 1,           // 注意:原答案中漏传了该字段,但接口文档要求存在
        "offer_name"   => null,
        "zip"          => 51143,
        "location"     => null,
        "maxdistance"  => 20,
        "target_group" => null,
        "age_group"    => null,
        "language"     => null,         // ✅ 拼写修正:language(非 laguage)
        "sort"         => "zip_asc",
        "record_offset"=> 0
    ]
];

$jsonPayload = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL            => "https://pflegefinder.bkk-dachverband.de/aua/rest_searchresult.php",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $jsonPayload,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json; charset=utf-8',
        'Content-Length: ' . strlen($jsonPayload)
    ],
    CURLOPT_COOKIE         => "PHPSESSID=2a4tctjc0ec6potr1p5a0tonir", // 替换为有效会话 ID
    CURLOPT_TIMEOUT        => 15,
    CURLOPT_FOLLOWLOCATION => false,
    CURLOPT_SSL_VERIFYPEER => false, // 生产环境请设为 true 并配置 CA 证书
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error    = curl_error($ch);
curl_close($ch);

if ($error) {
    die("cURL Error: $error");
}

echo "HTTP Status: $httpCode/n";
echo "Response:/n$response/n";

? 关键注意事项

酷表ChatExcel

酷表ChatExcel

北大团队开发的通过聊天来操作Excel表格的AI工具

下载

立即学习PHP免费学习笔记(深入)”;

  • 字段一致性:务必对照接口文档核对所有键名(如 language 易错拼为 laguage),一个字符错误即可触发后端 SQL 异常;
  • JSON 结构嵌套:服务端期望顶层为 { “searchdata”: { … } },不可扁平化或遗漏外层对象;
  • Cookie 管理:PHPSESSID 是会话标识,需从合法登录或前置请求中获取;若需自动维护会话,应启用 CURLOPT_COOKIEJAR + CURLOPT_COOKIEFILE;
  • 编码与长度头:添加 charset=utf-8 可避免中文乱码;手动设置 Content-Length 提升兼容性;
  • 安全性提醒:CURLOPT_SSL_VERIFYPEER => false 仅用于调试,生产环境必须启用 SSL 证书验证。

总结:发送 JSON 请求的核心在于——语义准确(字段名+结构)、格式规范(纯 JSON 字符串+正确 Header)、上下文完备(有效 Cookie/Referer)。跳过表单模拟,直击 JSON 本质,方能稳定对接现代 RESTful 接口。

https://www.php.cn/faq/1991193.html

发表回复

Your email address will not be published. Required fields are marked *