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 = ''; $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); 123 test
- 务必手动设置
Content-Type,否则默认是application/x-www-form-urlencoded,服务端大概率拒收 -
Content-Length可选,但显式声明更稳妥,尤其某些老系统会校验 - 不要对 XML 字符串做
urlencode()—— 那是给表单用的,会破坏 XML 结构
CURLOPT_POSTFIELDS 传数组:只在需要混合字段时用
极少数接口要求 XML 作为某个字段值(比如 data 字段),同时附带其他参数(token、format)。这时传数组,但 XML 仍需是原始字符串。
$xml = ''; $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); - book
- 这种用法下,XML 会被当成表单字段值,自动 urlencode,服务端收到的是转义后的字符串,需自行
html_entity_decode()或等效处理 - 除非接口文档明确说 “XML 放在 data 字段里”,否则别这么用——容易引发编码混乱
- 无法控制该字段的
Content-Type,multipart 中每个字段没有独立 MIME 类型
上传本地 XML 文件:用 curl_file_create() 而不是文件路径
如果你手头是一个磁盘上的 request.xml 文件,并且接口要求“上传文件”(比如带 行为),就必须用 curl_file_create() 创建 CURLFile 实例。
立即学习“PHP免费学习笔记(深入)”;
$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);
-
curl_file_create()是 PHP 5.5+ 才有的,低版本要用@/path语法(已废弃,且 PHP 8.0+ 移除) - 第二个参数是 MIME 类型,建议写
application/xml;第三个是上传后服务端看到的文件名,影响某些校验逻辑 - 不要把
curl_file_create()的结果再包进字符串或 json_encode —— 那会失效











