Laravel Guzzle Client多图上传问题求助：仅单张图片上传成功的解决方案

问题描述 #

我正在尝试使用GuzzleHTTP客户端上传多张图片，将图片以文件形式加载，但运行以下代码时仅能成功上传一张图片。

$clientPAimages = new Client();
$imagesPA = Req::file('images');
foreach($imagesPA as $image){
    $bodyImages[] = [
        'name' => 'image',
        'contents' => fopen($image->getRealPath(), 'r'),
        'filename' => $image->getClientOriginalName(),
        'headers' => [
            'Content-Type' => '<Content-type header>'
        ]
    ];
}
$responsePA3 = $clientPAimages->request('POST', 'link/images', [
    'multipart' => $bodyImages
]);
$responsePA3->getBody();

请问有没有人知道如何解决这个问题，即实现多张图片的成功上传与保存？

解决方案 #

问题核心在于你给所有文件字段都用了相同的name值image。在multipart表单上传机制里，多个文件共用同一个字段名时，后端通常只会接收最后一个文件。要让后端识别出这是一组文件，你需要把字段名改成数组形式image[]。

另外还有两个小细节可以优化：

• 把占位的<Content-type header>替换为图片实际的MIME类型，用$image->getMimeType()就能直接获取正确值
• 提前初始化$bodyImages数组，避免出现未定义变量的警告

修复后的代码如下：

$clientPAimages = new Client();
$imagesPA = Req::file('images');
// 提前初始化数组，避免未定义变量问题
$bodyImages = [];

foreach($imagesPA as $image){
    $bodyImages[] = [
        'name' => 'image[]', // 改为数组形式的字段名
        'contents' => fopen($image->getRealPath(), 'r'),
        'filename' => $image->getClientOriginalName(),
        'headers' => [
            'Content-Type' => $image->getMimeType() // 使用图片真实的MIME类型
        ]
    ];
}

$responsePA3 = $clientPAimages->request('POST', 'link/images', [
    'multipart' => $bodyImages
]);

$responsePA3->getBody();

最后要注意，后端接口也需要适配这个数组字段。比如在Laravel后端，你可以直接用$request->file('image')获取所有上传的图片（Laravel会自动解析带[]后缀的字段为数组）。

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