PHP cURL如何上传XML文件 CURLOPT_POSTFIELDS怎么用_技术教程

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_POSTFI ELDS 接收字符串、数组或 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 = '/path/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);