PHP 中使用 cURL 上传多个文件时，若直接用 "file[]" => $curlfile 形式赋值会导致后项覆盖前项；必须显式指定索引（如 "file[0]"、"file[1]"）或通过预处理函数自动展开数组，才能实现与 Shell curl -F "file[]@..." 等效的多文件提交行为。
php 中使用 curl 上传多个文件时，若直接用 `"file[]" => $curlfile` 形式赋值会导致后项覆盖前项；必须显式指定索引（如 `"file[0]"`、`"file[1]"`）或通过预处理函数自动展开数组，才能实现与 shell `curl -f "file[]@..."` 等效的多文件提交行为。
在 PHP 中通过 cURL 向服务端发送多个文件，是常见但易出错的操作。许多开发者尝试模仿 Shell 命令中简洁的 -F "file[]@file1.png" 语法，在 PHP 数组中写成：
$data = [ "g" => "GROUP", "o" => "object", "m" => "body.", "file[]" => $curlfile1, "file[]" => $curlfile2, // ❌ 错误：PHP 数组键名重复，后者覆盖前者 ];
由于 PHP 关联数组的键名唯一性，"file[]" 被重复声明两次，第二个赋值会完全覆盖第一个，最终仅传递 $curlfile2，服务端收到的 $_FILES['file'] 也仅含单个文件——这正是问题中观察到的现象。
✅ 正确做法是显式指定数字索引，使服务端能正确识别为同名数组字段：
$curlfile1 = new CURLFile('/path/to/file1.png', 'image/png', 'file1.png');
$curlfile2 = new CURLFile('/path/to/file2.pdf', 'application/pdf', 'file2.pdf');
$data = [
"g" => "GROUP",
"o" => "object",
"m" => "body.",
"file[0]" => $curlfile1,
"file[1]" => $curlfile2,
];
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => 'http://localhost/api/email.php',
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $data,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_SSL_VERIFYPEER => false,
]);
$response = curl_exec($ch);
curl_close($ch);此时服务端 $_FILES['file'] 将完整接收两个文件，结构与 Shell 命令一致：
立即学习“PHP免费学习笔记（深入）”；
Array(
[file] => Array(
[name] => Array([0] => file1.png, [1] => file2.pdf)
[type] => Array([0] => image/png, [1] => application/pdf)
[tmp_name] => Array([0] => /tmp/php..., [1] => /tmp/php...)
// ... 其他字段
)
)⚠️ 注意事项：
- CURLFile 构造函数参数顺序为 (filename, mime_type, post_filename)，其中 post_filename 是服务端看到的文件名，建议显式指定以避免路径泄露；
- 不要遗漏 CURLOPT_POST => true，否则 CURLOPT_POSTFIELDS 可能被忽略；
- 若需动态添加 N 个文件，不推荐手动拼接 [0]/[1] 索引，而应使用自动化方案。
? 进阶技巧：封装数组自动展开工具函数
为兼顾可读性与灵活性，可编写一个预处理器，将形如 "files" => [$f1, $f2, $f3] 的结构自动转换为 "files[0]", "files[1]", "files[2]"：
function expandFileArrays(array &$data): void {
$keysToProcess = [];
foreach ($data as $key => $value) {
// 仅处理值为数组且元素为 CURLFile 实例的字段
if (is_array($value) && !empty($value) &&
allCurlFiles($value)) {
$keysToProcess[] = $key;
}
}
foreach ($keysToProcess as $key) {
$values = $data[$key];
unset($data[$key]);
foreach ($values as $index => $val) {
$data[$key . '[' . $index . ']'] = $val;
}
}
}
// 辅助判断：是否所有元素均为 CURLFile 实例
function allCurlFiles(array $arr): bool {
foreach ($arr as $item) {
if (!$item instanceof CURLFile) {
return false;
}
}
return true;
}
// 使用示例
$files = [
new CURLFile('/tmp/a.png', 'image/png', 'a.png'),
new CURLFile('/tmp/b.pdf', 'application/pdf', 'b.pdf'),
];
$data = [
"g" => "GROUP",
"o" => "object",
"m" => "body.",
"file" => $files, // ✅ 自然语义化写法
];
expandFileArrays($data); // 自动转为 "file[0]", "file[1]"该方案既保持了代码清晰性，又规避了手动索引维护成本，适合中大型项目复用。
? 总结：PHP cURL 多文件上传没有原生支持 "key[]" 语法的“魔法机制”，这是语言层面限制而非 cURL 扩展缺陷。开发者应主动采用索引明确或工具函数辅助的方式，确保 $_FILES 结构与预期一致——毕竟，可靠的数据交付，永远比语法糖更重要。
