如何使用 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 数据，彻底规避因格式错误引发的后端异常。