![PHP cURL 多文件上传：解决 file[] 数组键名覆盖问题的完整方案](https://img.php.cn/upload/article/001/246/273/177313363969688.jpg)
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 向服务端提交多个文件时，开发者常期望复现命令行 curl -F "file[]@file1.png" -F "file[]@file2.pdf" 的语义——即服务端接收到一个名为 file 的完整多维上传数组（含 name、tmp_name、type 等子数组）。然而，直接在 PHP 数组中重复使用相同键名 "file[]" 会导致后赋值覆盖前赋值：
// ❌ 错误写法：PHP 数组键名重复，$curlfile2 覆盖 $curlfile1 $data = [ "g" => "GROUP", "o" => "object", "m" => "body.", "file[]" => $curlfile1, // 此行被下一行覆盖 "file[]" => $curlfile2, // 实际仅此生效 ];
这是因为 PHP 关联数组的键是唯一字符串，"file[]" 作为字符串键无法表达“追加到数组”的语义（不同于 shell curl 的 -F 参数解析逻辑）。最终服务端 $_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 或用户上传队列）时，手动编号易出错。可封装一个健壮的 postArrayFixer() 函数，将形如 "files" => [$f1, $f2, $f3] 的结构自动转换为 "files[0]", "files[1]", "files[2]"：
function postArrayFixer(array &$data): void {
$keysToProcess = array_keys($data);
foreach ($keysToProcess as $key) {
$value = $data[$key];
// 仅对数组或 Traversable 类型的值进行展开（排除字符串、数字等）
if (is_array($value) || $value instanceof Traversable) {
$indexed = array_values($value); // 重置为数字索引，确保顺序
foreach ($indexed as $i => $item) {
$data[$key . '[' . $i . ']'] = $item;
}
unset($data[$key]); // 移除原始键
}
}
}
// 使用示例
$files = [
new CURLFile('/tmp/report.pdf', 'application/pdf'),
new CURLFile('/tmp/chart.png', 'image/png'),
new CURLFile('/tmp/data.json', 'application/json')
];
$data = [
"g" => "GROUP",
"o" => "object",
"m" => "body.",
"file" => $files, // 注意：此处用 "file"（无方括号），非 "file[]"
];
postArrayFixer($data);
// $data 现在包含："file[0]", "file[1]", "file[2]"，可直接传给 CURLOPT_POSTFIELDS
$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);⚠️ 重要注意事项：
- CURLFile 构造必须完整：推荐使用三参数形式 new CURLFile($path, $mime, $postName)，避免因 MIME 类型缺失导致服务端识别失败；
- 不要混用 @ 语法：PHP 5.6+ 已弃用 "@/path" 写法，强制使用 CURLFile 对象，否则可能触发警告或上传失败；
- 服务端兼容性：该方案生成的 $_FILES 结构与 shell curl 完全一致，无需修改接收端代码；
- 键名一致性：预处理器仅处理值为数组的字段，不会影响 "g", "o" 等普通字段，确保其他参数安全保留。
? 总结：PHP 数组本身不支持“同名多值”语法，因此 "file[]" 在 CURLOPT_POSTFIELDS 中无法自动展开。务实方案是——要么显式编号（适合固定文件数），要么用预处理器函数（适合动态场景）。两者均能 100% 复现 shell curl 的多文件语义，且无第三方依赖，是生产环境推荐的最佳实践。
立即学习“PHP免费学习笔记（深入）”；
