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

如何使用 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 环境中有效)。

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

站酷梦笔

站酷梦笔

国内知名设计社区站酷推出的AI插画生成工具

下载

 [
        "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免费学习笔记(深入)”;

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

发表回复

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