17370845950

XML上传应据接口要求选择方式：纯XML接口用CURLOPT_POSTFIELDS传字符串并设Content-Type: application/xml；字段嵌套用数组；文件上传则用curl_file_create()。

XML文件上传必须用 CURLOPT_POSTFIELDS 配合 CURLOPT_HTTPHEADER

直接把 XML 字符串赋给 CURLOPT_POSTFIELDS 是最常用也最稳妥的方式，但很多人忽略 HTTP 头设置，导致服务端收不到或解析失败。XML 不是表单数据，不能靠 multipart/form-data 自动包装——除非接口明确要求带文件字段名的二进制上传。

• 如果接口文档写的是 “POST raw XML”，就该传字符串 + Content-Type: text/xml 或 application/xml
• 如果写的是 “上传 file 字段”，才需要用 curl_file_create() 构造 CURLFile 对象
• CURLOPT_POSTFIELDS 接收字符串、数组或 CURLFile 对象，类型不同，cURL 行为完全不同

CURLOPT_POSTFIELDS 传字符串：适合纯 XML 接口

这是绝大多数 XML WebService（如 SOAP、自定义 REST XML 接口）的要求。cURL 会把整个字符串当请求体发送，不加任何边界或编码。

$xml = '123test';
$ch = curl_init('https://api.example.com/submit');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $xml);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/xml',
    'Content-Length: ' . strlen($xml)
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

• 务必手动设置 Content-Type，否则默认是 application/x-www-form-urlencoded，服务端大概率拒收
• Content-Length 可选，但显式声明更稳妥，尤其某些老系统会校验
• 不要对 XML 字符串做 urlencode() —— 那是给表单用的，会破坏 XML 结构

CURLOPT_POSTFIELDS 传数组：只在需要混合字段时用

极少数接口要求 XML 作为某个字段值（比如 data 字段），同时附带其他参数（token、format）。这时传数组，但 XML 仍需是原始字符串。

$xml = 'book';
$data = [
    'token'  => 'abc123',
    'format' => 'xml',
    'data'   => $xml  // 注意：这里不是文件路径，也不是 CURLFile
];
$ch = curl_init('https://api.example.com/upload');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
// 此时 cURL 自动设为 multipart/form-data，XML 会被当普通字段值编码
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

• 这种用法下，XML 会被当成表单字段值，自动 urlencode，服务端收到的是转义后的字符串，需自行 html_entity_decode() 或等效处理
• 除非接口文档明确说 “XML 放在 data 字段里”，否则别这么用——容易引发编码混乱
• 无法控制该字段的 Content-Type，multipart 中每个字段没有独立 MIME 类型

上传本地 XML 文件：用 curl_file_create() 而不是文件路径

如果你手头是一个磁盘上的 request.xml 文件，并且接口要求“上传文件”（比如带 行为），就必须用 curl_file_create() 创建 CURLFile 实例。

$xmlFile = '/p
ath/to/request.xml';
if (!file_exists($xmlFile)) {
    die('XML file not found');
}
$ch = curl_init('https://api.example.com/upload');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'file' => curl_file_create($xmlFile, 'application/xml', 'request.xml')
]);
// 注意：此时不能再设 Content-Type 为 application/xml，cURL 会自动设 multipart 头
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

• curl_file_create() 是 PHP 5.5+ 才有的，低版本要用 @/path 语法（已废弃，且 PHP 8.0+ 移除）
• 第二个参数是 MIME 类型，建议写 application/xml；第三个是上传后服务端看到的文件名，影响某些校验逻辑
• 不要把 curl_file_create() 的结果再包进字符串或 json_encode —— 那会失效

实际调用中最容易出问题的，是混淆了「传 XML 内容」和「传 XML 文件」两种场景，结果 Content-Type 错、编码错、边界错——盯着接口文档里的请求示例比看 PHP 手册还管用。