使用Guzzle将文件从Lumen服务器发送至另一PHP服务器报错问题

你在把Lumen接收的文件通过Guzzle转发到CodeIgniter服务器时踩了个常见的坑——直接把$_FILES['avatar']数组传给Guzzle的multipart参数，而Guzzle根本没法正确解析这个元信息数组作为文件内容，这就是报错的核心原因。

为什么原代码会出错？ #

$_FILES['avatar']里存的是文件的元数据：临时路径、文件名、文件类型这些信息，但Guzzle的multipart字段需要的是文件的实际内容流或者可读取的文件路径，直接传元信息数组相当于给了它一堆没用的字符串，自然会解析失败。

修正后的实现代码 #

在Lumen里，推荐用Laravel封装好的UploadedFile实例来处理上传文件，比直接操作$_FILES更安全便捷，下面是调整后的完整代码：

// 1. 获取Lumen接收的上传文件实例
$avatarFile = $request->file('avatar');

// 2. 构造要发送的额外表单数据
$data = [];
foreach ($request->input() as $key => $val) {
    $data[] = [
        'name' => $key,
        'contents' => $val
    ];
}

// 3. 正确附加文件到multipart请求
if ($avatarFile && $avatarFile->isValid()) {
    $data[] = [
        'name' => 'avatar',
        'contents' => fopen($avatarFile->getPathname(), 'r'), // 读取临时文件的资源流
        'filename' => $avatarFile->getClientOriginalName() // 可选：保留用户上传的原文件名
    ];
}

// 4. 发送请求到CodeIgniter服务器
$res = $this->client->request('POST', 'https://myapiserver.com/api/update/profile', [
    'multipart' => $data
]);

return response()->json(json_decode($res->getBody()->getContents()));

关键细节说明 #

• 用$request->file('avatar')获取UploadedFile对象，它提供了getPathname()（临时文件的真实路径）、getClientOriginalName()（用户上传的原文件名）等实用方法。
• 通过fopen()打开临时文件的只读资源流，这是Guzzle能正确识别的文件内容格式。
• 加上filename参数能让CodeIgniter端拿到正确的文件名，避免出现随机临时文件名的问题。

额外检查点 #

• 确认Lumen服务器的临时文件目录权限正常，PHP有读取权限。
• 检查CodeIgniter端的接口是否配置正确，能正常接收multipart/form-data格式的文件（比如验证$_FILES['avatar']是否存在且有效）。

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