PHP CURL POST上传文件时如何提交含子数组的表单字段？

首先，你遇到的问题根源在于：当使用CURLOPT_POSTFIELDS传入嵌套数组时，PHP CURL默认不会自动将子数组解析为var[]=xxx格式的多字段参数——尤其是在上传文件必须用到的multipart/form-data编码场景下，嵌套数组会被错误处理，导致后端无法完整接收数据。

下面是两种可行的解决方案：

方案一：手动指定数组字段键名（推荐） #

构建POST数据时，将子数组对应的键名设置为var[]，值直接传入子数组。CURL会自动将其展开为多个var[]字段，后端PHP可以通过$_POST['var']获取完整数组：

// 初始化CURLFile对象，确保文件路径正确且有读取权限
$filename = 'path/to/your/target-file.jpg';
$curlfile = curl_file_create(
    $filename,
    mime_content_type($filename), // 自动获取文件MIME类型
    basename($filename) // 设置上传后的文件名
);

// 构建POST数据：关键是将子数组的键设为var[]
$postdata = array(
    'file' => $curlfile,
    'var[]' => array('value1', 'value2')
);

// 初始化并配置CURL会话
$ch = curl_init('https://httpbin.org/post');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postdata);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 执行请求并处理结果
$response = curl_exec($ch);
curl_close($ch);

print_r(json_decode($response, true));

执行后，httpbin返回的form字段会显示完整的var数组，后端用print_r($_POST)也能看到预期的结果。

方案二：逐个添加数组元素（适用于需精确控制字段顺序的场景） #

如果需要单独控制每个数组元素的提交顺序，可以通过索引键避免重复键名冲突，CURL同样能正确解析：

$filename = 'path/to/your/target-file.jpg';
$curlfile = curl_file_create(
    $filename,
    mime_content_type($filename),
    basename($filename)
);

// 逐个指定数组元素的索引键
$postdata = array(
    'file' => $curlfile,
    'var[0]' => 'value1',
    'var[1]' => 'value2'
);

// 后续CURL配置与方案一一致
$ch = curl_init('https://httpbin.org/post');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postdata);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

print_r(json_decode($response, true));

这种方式下，后端的$_POST['var']同样会是包含两个元素的数组，效果和方案一一致。

额外注意事项 #

• 确保PHP版本在5.5及以上：curl_file_create是PHP 5.5引入的，替代了旧版本的@符号上传方式（@已被弃用，不推荐使用）。
• 检查文件权限：PHP进程需要有读取目标上传文件的权限，否则会导致文件上传失败。
• 适配后端规则：如果后端不是PHP，需要确认其解析multipart/form-data数组的规则，部分语言可能要求使用var[]格式，部分则接受var作为数组键。

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