如何在 PHP 中正确实现与命令行 cURL 一致的 JSON POST 请求-php教程-PHP中文网

如何在 PHP 中正确实现与命令行 cURL 一致的 JSON POST 请求

本文详解 php curl 发送嵌套 json 数据时的常见错误（如误将业务字段放入 http 头），提供结构化构建请求体、正确设置选项及编码验证的完整解决方案。

本文详解 php curl 发送嵌套 json 数据时的常见错误（如误将业务字段放入 http 头），提供结构化构建请求体、正确设置选项及编码验证的完整解决方案。

在将命令行 curl 成功请求迁移到 PHP 时，一个高频陷阱是混淆 HTTP 请求头（Headers）与请求体（Request Body）的职责边界。从你提供的原始 cURL 命令可见："Header": {"Token": "xyz"} 是作为 JSON 数据的一部分（即 payload）发送到服务端的，而非 HTTP 头字段。但你的 PHP 代码中却将 Token 错误地尝试通过 CURLOPT_HTTPHEADER 设置——这会导致服务端无法在请求体中解析出预期的 Header.Token，从而返回 INVALID_REQUEST 错误。

✅ 正确做法是：所有业务数据（包括 Header 和 Body 对象）必须统一序列化为 JSON 字符串，并通过 CURLOPT_POSTFIELDS 提交；而 Content-Type: application/json 才是唯一应出现在 HTTP 头中的相关字段。

以下是经过验证、可直接运行的规范 PHP 实现：

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

<?php $url = 'http://example.com';

// 构建结构化请求数据（避免手动拼接 JSON 字符串，防止引号/转义错误）
$data = [
    'Header' => [
        'Token' => 'xyz'
    ],
    'Body' => [
        'Email' => '[email@domain.com]', // 注意：实际使用时请替换为真实邮箱，移除 HTML 标签（如 <a>）
        'FirstName' => 'test',
        'Surname' => 'test'
    ]
];

// 安全 JSON 编码（PHP 7.3+ 推荐启用异常抛出）
$jsonPayload = json_encode($data, JSON_THROW_ON_ERROR);

// 初始化 cURL
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL            => $url,
    CURLOPT_RETURNTRANSFER => true,   // 关键：捕获响应而非直接输出
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $jsonPayload,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Accept: application/json' // 可选：明确告知服务器期望接收 JSON 响应
    ],
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_FOLLOWLOCATION => true,
    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 ($response === false) {
    throw new RuntimeException("cURL Error: {$error}");
}

echo "HTTP Status: {$httpCode}\n";
echo "Response: {$response}\n";</a>

⚠️ 关键注意事项：

邮箱字段清理：原始示例中 <a class="__cf_email__" ...></a> 是 Cloudflare 邮箱保护生成的混淆 HTML，服务端几乎必然无法解析该字符串为有效邮箱。务必在发送前提取真实邮箱（如通过 data-cfemail 解码或直接使用明文邮箱）。
JSON 编码可靠性：始终使用 json_encode() 动态生成 JSON，而非硬编码字符串——避免引号嵌套、特殊字符转义失败等问题。配合 JSON_THROW_ON_ERROR 可及时捕获序列化异常。
响应处理：务必检查 curl_exec() 返回值是否为 false，并使用 curl_error() 获取底层错误信息（如 DNS 失败、连接超时等）。
生产安全：禁用 CURLOPT_SSL_VERIFYPEER => false，改用系统 CA 包或指定 CURLOPT_CAINFO。