PHP中是否存在multipart/form-data版http_build_query及类似JS的FormData？

核心结论 #

PHP没有原生的、和JavaScript FormData完全对等的开箱即用工具，但可以通过手动构造格式或借助第三方库来生成multipart/form-data格式的响应，实现返回多文件的需求。

方法一：手动构造multipart/form-data响应 #

这是最直接的方式，无需依赖任何库，只需按multipart格式规范拼接内容即可：

<?php
// 生成唯一的边界符（用于分隔不同文件部分）
$boundary = '----CustomBoundary' . md5(uniqid(mt_rand(), true));

// 设置响应头，指定内容类型和边界符
header("Content-Type: multipart/form-data; boundary={$boundary}");

// 定义要返回的文件列表（替换为你的实际文件路径和名称）
$files = [
    ['filename' => 'report.pdf', 'file_path' => '/var/www/files/report.pdf'],
    ['filename' => 'data.csv', 'file_path' => '/var/www/files/data.csv']
];

// 逐个拼接文件部分
foreach ($files as $file) {
    // 输出当前文件的头部信息
    echo "--{$boundary}\r\n";
    echo "Content-Disposition: form-data; name=\"attachments[]\"; filename=\"{$file['filename']}\"\r\n";
    // 自动获取文件的MIME类型
    echo "Content-Type: " . mime_content_type($file['file_path']) . "\r\n\r\n";
    // 输出文件内容（用readfile高效读取并输出，避免内存占用过高）
    readfile($file['file_path']);
    echo "\r\n";
}

// 输出结束边界
echo "--{$boundary}--\r\n";
exit;
?>

方法二：借助第三方库简化操作 #

如果不想手动处理格式细节，可以用HTTP客户端库的工具来生成multipart流，比如Guzzle的MultipartStream（原本用于构建请求，但也可用于生成响应内容）：

<?php
// 引入Guzzle的自动加载文件（需先通过Composer安装：composer require guzzlehttp/guzzle）
require 'vendor/autoload.php';

use GuzzleHttp\Psr7\MultipartStream;

// 生成边界符
$boundary = '----GuzzleBoundary' . md5(uniqid());

// 构造文件部分数组
$parts = [
    [
        'name'     => 'attachments[]',
        'filename' => 'report.pdf',
        'contents' => fopen('/var/www/files/report.pdf', 'r'),
        'headers'  => ['Content-Type' => mime_content_type('/var/www/files/report.pdf')]
    ],
    [
        'name'     => 'attachments[]',
        'filename' => 'data.csv',
        'contents' => fopen('/var/www/files/data.csv', 'r'),
        'headers'  => ['Content-Type' => mime_content_type('/var/www/files/data.csv')]
    ]
];

// 创建Multipart流对象
$multipartStream = new MultipartStream($parts, $boundary);

// 设置响应头
header("Content-Type: multipart/form-data; boundary={$boundary}");
header("Content-Length: " . $multipartStream->getSize());

// 输出流内容
echo $multipartStream;
exit;
?>

补充说明 #

• PHP原生的$_FILES超全局变量是用于接收客户端上传的multipart数据，而非生成响应，所以没有直接对应JS FormData的生成工具。
• 手动构造时要注意边界符的唯一性，以及格式中的换行符必须是\r\n（符合HTTP规范）。

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