如何在 PHP 中正确使用 cURL 发送 JSON 数据的 PUT 请求-php教程-PHP中文网

如何在 PHP 中正确使用 cURL 发送 JSON 数据的 PUT 请求

PHP 的 CURLOPT_PUT 仅适用于上传文件，不能配合 CURLOPT_POSTFIELDS 发送 JSON 负载；应改用 CURLOPT_CUSTOMREQUEST => 'PUT' 并显式设置请求体与认证头。

php 的 `curlopt_put` 仅适用于上传文件，不能配合 `curlopt_postfields` 发送 json 负载；应改用 `curlopt_customrequest => 'put'` 并显式设置请求体与认证头。

在 PHP 中通过 cURL 发起标准的 RESTful PUT 请求（尤其是携带 JSON 数据）时，一个常见误区是误用 CURLOPT_PUT => true。该选项并非通用的 HTTP 方法切换开关，而是专为「上传本地文件」设计：它要求同时设置 CURLOPT_INFILE（文件句柄）和 CURLOPT_INFILESIZE（文件大小），否则 cURL 将忽略 CURLOPT_POSTFIELDS，导致请求体为空——这正是你遇到“数据未提交”“卡在 100 Continue 后超时”的根本原因。

✅ 正确做法是：使用 CURLOPT_CUSTOMREQUEST => 'PUT' 显式声明方法，并通过 CURLOPT_POSTFIELDS 传递 JSON 字符串，同时确保 Content-Type 和认证头正确配置。

以下是推荐的、健壮可复用的 PHP cURL PUT 实现：

Browser Js

轻量级CDP浏览器控制，适用于AI代理。相较于内置浏览器工具，token消耗降低3‑10倍，仅在浏览时使用。

下载

<?php $jsondata = json_encode([
    'name' => 'Example',
    'active' => true
]);

$authHeader = 'Basic ' . base64_encode($config['uag']['user'] . ':' . $config['uag']['pass']);

foreach ($serverurilist as $uri) {
    $curl = curl_init();

    curl_setopt_array($curl, [
        CURLOPT_URL => $uri,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => 'PUT',
        CURLOPT_POSTFIELDS => $jsondata,
        CURLOPT_HTTPHEADER => [
            'Content-Type: application/json',
            'Content-Length: ' . strlen($jsondata), // 显式声明长度，避免 100-continue 陷阱
            $authHeader
        ],
        // 关键：禁用 Expect: 100-continue 行为（常引发阻塞）
        CURLOPT_HTTPHEADER => array_merge(
            ['Content-Type: application/json', $authHeader],
            [strlen($jsondata) > 0 ? 'Content-Length: ' . strlen($jsondata) : '']
        ),
        CURLOPT_SSL_VERIFYPEER => false,
        CURLOPT_SSL_VERIFYHOST => false,
        CURLOPT_TIMEOUT => 30,
        CURLOPT_VERBOSE => false, // 生产环境建议关闭
    ]);

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

    if ($response === false) {
        throw new RuntimeException("cURL error ({$httpCode}): {$error}");
    }

    echo "URI: {$uri} → Status: {$httpCode}\n";
    var_dump($response);
}

? 关键注意事项：

永远不要混用 CURLOPT_PUT 和 CURLOPT_POSTFIELDS：前者是文件上传专用，后者用于表单/JSON 负载。
显式设置 Content-Length 头：可有效规避服务器因等待 100 Continue 确认而挂起的问题（尤其在自签名证书或代理环境下）。
使用 Authorization: Basic ... 替代 CURLOPT_USERNAME/CURLOPT_PASSWORD：更可控，且兼容所有 cURL 版本；CURLOPT_USERNAME 在部分旧版本中可能不触发 Basic 认证头。
禁用 Expect: 100-continue：若仍遇阻塞，可在 CURLOPT_HTTPHEADER 中加入 'Expect:'（空值）彻底禁用该机制。
始终校验 curl_exec() 返回值：false 表示传输失败（非 HTTP 错误码），需结合 curl_error() 排查。