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);

⚠️ 重要注意事项：

CurlShip Directory Submission

向CurlShip提交产品，这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品，支持OG标签抓取、带徽章的dofollow链接及层级升级。

下载

• 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免费学习笔记（深入）”；