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

本文详解如何通过 curl 向后端（如 `rest_searchresult.php`）以 post 方式提交标准 json 格式请求，重点纠正常见错误（如字段拼写、content-type 设置、数据序列化方式），并提供可直接运行的 php 示例代码。

在调用类似 https://pflegefinder.bkk-dachverband.de/aua/rest_searchresult.php 这类 REST 风格接口时，必须确保 jsON 数据结构准确、HTTP 头部规范、且请求方法语义正确。原问题中出现 sql 错误，根本原因并非网络或认证问题，而是请求体中存在拼写错误（如 “laguage” → “language”）及数据封装方式不当，导致后端解析失败并触发未过滤的数据库查询异常。

✅ 正确做法：原生 json 字符串 + application/json 头

不应使用 urlencode(json_encode(…)) 或将 JSON 作为表单字段嵌套（如 array(“searchdata” => $json_String)），而应：

• 直接构造合法 JSON 字符串（注意：NULL 在 JSON 中为小写，PHP 中需用 null 值，json_encode() 会自动处理）；
• 显式设置 Content-Type: application/json；
• 使用 curlOPT_POSTFIELDS 传入纯字符串形式的 JSON；
• 禁用 CURLOPT_POST（改用 CURLOPT_CUSTOMREQUEST => “POST” 更明确）；
• 如需会话维持，正确传递 PHPSESSID cookie（而非依赖 session_id() 动态获取——该值通常不在 CLI 环境中有效）。

以下是经过验证、可直接运行的完整示例：

 [         "required"      => 1,         "statistics"    => 1, // 注意：原答案示例中漏传此字段，但接口实际需要         "offer_name"    => null,         "zip"           => 51143,         "location"      => null,         "maxdistance"   => 20,         "target_group"  => null,         "age_group"     => null,         "language"      => null, // ⚠️ 关键修正：不是 "laguage"         "sort"          => "zip_asc",         "record_offset" => 0     ] ];  $jsonPayload = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); if ($jsonPayload === false) {     throw new RuntimeException('JSON 编码失败: ' . json_last_error_msg()); }  $curl = curl_init(); curl_setopt_array($curl, [     CURLOPT_URL            => "https://pflegefinder.bkk-dachverband.de/aua/rest_searchresult.php",     CURLOPT_RETURNTRANSFER => true,     CURLOPT_ENCODING       => "",     CURLOPT_MAXREDIRS      => 10,     CURLOPT_TIMEOUT        => 30,     CURLOPT_HTTP_VERSION   => CURL_HTTP_VERSION_1_1,     CURLOPT_CUSTOMREQUEST  => "POST",     CURLOPT_POSTFIELDS     => $jsonPayload,     CURLOPT_HTTPHEADER     => [         'Content-Type: application/json',         'Accept: application/json'     ],     // 若需保持会话，请替换为实际有效的 PHPSESSID（可通过浏览器开发者工具获取）     CURLOPT_COOKIE         => "PHPSESSID=2a4tctjc0ec6potr1p5a0tonir; MK_CookieConsent=%7B%22required%22%3Atrue%2C%22statistics%22%3Atrue%7D" ]);  $response = curl_exec($curl); $err = curl_error($curl); $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);  curl_close($curl);  if ($err) {     echo "cURL Error: " . $err; } elseif ($httpCode >= 400) {     echo "HTTP Error {$httpCode}: " . $response; } else {     echo "Success:n" . $response; }

⚠️ 关键注意事项

• 字段名必须完全匹配：接口对键名大小写与拼写极为敏感（如 language 写成 laguage 将导致后端 SQL 查询条件缺失，引发报错）；
• 不要手动 urlencode JSON：json_encode() 输出已是 UTF-8 字符串，再 urlencode() 会破坏 JSON 结构；
• Cookie 要真实有效：PHPSESSID 必须来自有效会话（建议先模拟登录获取），且 MK_CookieConsent 等必要同意 Cookie 也需一并携带；
• 避免 GET 参数干扰：目标 URL 应为纯净接口地址（如 …/rest_searchresult.php），勿附加时间戳等无关 query string；
• 调试建议：启用 CURLOPT_VERBOSE => true 查看完整请求头/体，或先用 Insomnia/postman 验证请求逻辑。

遵循以上规范，即可稳定、安全地通过 cURL 提交 JSON 数据，彻底规避因格式错误引发的后端异常。

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