使用CURL调用提交POST参数及文件的问题求助

问题场景 #

我通过AJAX将表单数据提交到控制器，再在控制器中用CURL向第三方URL传递POST变量和文件，但数据始终未成功送达。控制器代码、CURL逻辑如下，返回的错误提示和Postman不传参数时完全一致（截图显示必填字段custId和xmlfile未被识别）。

控制器获取数据代码 #

$clientId = $this->request->data['clientSsoCert'];

// 需要上传的文件信息
$xmlTmpPath = $this->request->data['clientSsoXml']['tmp_name'];
$xmlType = $this->request->data['clientSsoXml']['type'];
$xmlName = $this->request->data['clientSsoXml']['name'];
$xmlNameCmps = explode(".", $xmlName);
$xmlExtension = strtolower(end($xmlNameCmps));

原CURL调用代码 #

$strRequestURL = 'https://abcd.com';
try {
    $conn = curl_init($strRequestURL);

    curl_setopt($conn, CURLOPT_URL, $strRequestURL);
    curl_setopt($conn, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($conn, CURLOPT_POST, true);
    curl_setopt($conn, CURLOPT_HTTPHEADER, array('Content-Type:multipart/form-data'));
    curl_setopt($conn, CURLOPT_POSTFIELDS, ['custId' => $clientId , 'xmlfile' => $xmlTmpPath]);
    curl_setopt($conn, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($conn, CURLOPT_SSL_VERIFYHOST, false);

    $output = curl_exec($conn);

    if (curl_errno($conn)) {
        return ['status' => false, 'error' => curl_error($conn)];
    } else {
        $response = json_decode($output);
        if ($response->status == 'error') {
            return ['status' => false, 'error' => $response->errorMessage];
        } else {
            return ['status' => true, 'xmlFileName' => ($response->xmlfileName) ?? "", 'certFileName' => ($response->certfileName) ?? ""];
        }
    }
    curl_close($conn);
} catch (\Exception $e) {
    return ['status' => false, 'error' => $e->getMessage()];
}

错误提示截图 #

错误原因 #

1. 手动设置Content-Type导致解析失败：手动指定multipart/form-data时，CURL不会自动生成表单数据的分隔边界，服务器无法正确识别表单中的字段和文件。
2. 文件参数格式错误：直接传递临时文件路径无法被CURL识别为文件上传，需要使用特定格式告知CURL这是一个文件。

修复后的代码 #

$strRequestURL = 'https://abcd.com';
try {
    $conn = curl_init($strRequestURL);

    curl_setopt($conn, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($conn, CURLOPT_POST, true);
    // 移除手动设置的Content-Type，让CURL自动生成带边界的正确头信息
    // curl_setopt($conn, CURLOPT_HTTPHEADER, array('Content-Type:multipart/form-data'));
    
    // 使用CURLFile构造文件上传参数（PHP 5.5及以上版本推荐用法）
    $xmlUploadFile = new CURLFile(
        $xmlTmpPath,
        $xmlType,
        $xmlName
    );
    
    // 组装POST数据，包含普通字段和文件
    curl_setopt($conn, CURLOPT_POSTFIELDS, [
        'custId' => $clientId,
        'xmlfile' => $xmlUploadFile
    ]);
    
    // 生产环境请务必移除这两行，配置正确的SSL证书
    curl_setopt($conn, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($conn, CURLOPT_SSL_VERIFYHOST, false);

    $output = curl_exec($conn);

    if (curl_errno($conn)) {
        return ['status' => false, 'error' => curl_error($conn)];
    } else {
        $response = json_decode($output);
        if ($response->status == 'error') {
            return ['status' => false, 'error' => $response->errorMessage];
        } else {
            return ['status' => true, 'xmlFileName' => ($response->xmlfileName) ?? "", 'certFileName' => ($response->certfileName) ?? ""];
        }
    }
    curl_close($conn);
} catch (\Exception $e) {
    return ['status' => false, 'error' => $e->getMessage()];
}

额外说明 #

• 低版本PHP兼容：如果使用PHP 5.5以下版本，无法使用CURLFile，可以改用@前缀格式：

  // 需确保CURLOPT_SAFE_UPLOAD设为false（PHP 5.5+默认关闭该特性）
  curl_setopt($conn, CURLOPT_SAFE_UPLOAD, false);
  curl_setopt($conn, CURLOPT_POSTFIELDS, [
      'custId' => $clientId,
      'xmlfile' => "@{$xmlTmpPath};type={$xmlType};filename={$xmlName}"
  ]);
  

• 安全提示：生产环境中绝对不能关闭CURLOPT_SSL_VERIFYPEER和CURLOPT_SSL_VERIFYHOST，这会导致请求被中间人攻击，应该配置服务器信任的CA证书路径。

内容的提问来源于stack exchange，提问作者Amit Joshi