如何正确将 cURL 命令转换为 PHP 的 curl_exec 实现-php教程-PHP中文网

如何正确将 cURL 命令转换为 PHP 的 curl_exec 实现

本文详解为何直接复制 curl 命令到 php 会失败，并提供结构清晰、可复用的 php curl post 请求实现方案，重点纠正请求体（json payload）与 http 头部的混淆问题，确保 token 等参数正确嵌入 json 数据而非错误地设为 header。

本文详解为何直接复制 curl 命令到 php 会失败，并提供结构清晰、可复用的 php curl post 请求实现方案，重点纠正请求体（json payload）与 http 头部的混淆问题，确保 token 等参数正确嵌入 json 数据而非错误地设为 header。

在将命令行 curl 成功请求迁移到 PHP 时，一个常见却极易被忽视的错误是：误将 JSON 请求体中的字段（如 Header.Token）当作 HTTP 请求头设置。从原始问题可见，curl -X POST ... -d '{"Header": {"Token": "xyz"}, ...}' 明确将 Token 放在请求体（payload）内；而错误的 PHP 实现却试图通过 CURLOPT_HTTPHEADER 传递它，导致服务端解析出空或无效的 Header.Token，从而返回 {"Status":"ERROR","ErrorMsg":"INVALID_REQUEST"}。

正确的做法是：仅用 CURLOPT_HTTPHEADER 设置协议级头部（如 Content-Type），所有业务数据（含嵌套的 Header 和 Body）必须构造为关联数组后，统一 json_encode() 为字符串，再赋值给 CURLOPT_POSTFIELDS。

以下是推荐的健壮实现：

Test Curl 2

父母的功课——育儿心理学对话支持技能（心虫增强版）。提供结构化对话、情绪识别、场景匹配与安全检测；可选Python脚本（scripts/）在SKILL_DIR/data/本地存储评估历史、洞察与会话状态，不对外传输。核心路径：觉察（看见防御）→接纳（慈悲是……

下载

<?php $url = 'http://example.com';
$data = [
    'Header' => [
        'Token' => 'xyz'
    ],
    'Body' => [
        'Email' => '[email@protected]', // 注意：实际使用时请替换为真实邮箱，此处保留原文中被 Cloudflare 邮箱保护的 HTML 标签仅为示例；生产环境应使用纯文本邮箱
        'FirstName' => 'test',
        'Surname' => 'test'
    ]
];

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL            => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($data, JSON_THROW_ON_ERROR),
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        // 可选：添加其他必要 Header，如 Authorization、Accept 等
    ],
    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 ($error) {
    throw new RuntimeException("cURL error: {$error}");
}

// 解析响应（假设返回 JSON）
$result = json_decode($response, true);
if (json_last_error() !== JSON_ERROR_NONE) {
    throw new RuntimeException("Invalid JSON response: " . substr($response, 0, 200));
}

echo "HTTP Status: {$httpCode}\n";
print_r($result);

✅ 关键要点总结：

✅ Token 属于业务逻辑字段，必须位于 JSON payload 内（即 $data['Header']['Token']），绝不可写进 CURLOPT_HTTPHEADER；
✅ 使用 json_encode($array, JSON_THROW_ON_ERROR) 提升错误可追溯性，避免静默失败；
✅ 显式设置 CURLOPT_RETURNTRANSFER => true 是获取响应内容的前提（否则 curl_exec() 默认直接输出）；
⚠️ 注意邮箱字段：原始代码中 <a class="__cf_email__"></a> 是 Cloudflare 邮箱混淆 HTML，PHP 后端无法解析该标签——调用前务必提取纯文本邮箱（如 [email@protected]），否则服务端校验会失败；
⚠️ 生产环境禁用 CURLOPT_SSL_VERIFYPEER => false，应配置有效的 SSL 证书路径。