如何在 PHP 表单中正确处理多文件上传-php教程-PHP中文网

如何在 PHP 表单中正确处理多文件上传

本文详解如何修改 PHP 表单处理器，使其支持提交的多个文件，包括文件数组解析、逐个验证、编码与邮件附件组装等完整流程。

本文详解如何修改 php 表单处理器，使其支持 `` 提交的多个文件，包括文件数组解析、逐个验证、编码与邮件附件组装等完整流程。

在 HTML 表单中启用多文件上传仅需为添加 multiple 属性并使用数组式名称（如 name="userImages[]"），但后端 PHP 必须适配 $_FILES 的二维数组结构——这是多数开发者踩坑的核心原因。原代码将 $_FILES['userImages'] 当作单维数组处理（如 $_FILES['userImages']['name']），而实际它是一个按字段键（name, tmp_name, size, error, type）组织的二维数组，需按索引遍历每个上传项。

✅ 正确解析多文件上传数据

当表单提交多个文件时，$_FILES['userImages'] 结构如下：

[
  'name'     => ['photo1.jpg', 'logo.png', 'scan.pdf'],
  'tmp_name' => ['/tmp/phpabc123', '/tmp/phpdef456', '/tmp/phpghi789'],
  'size'     => [102400, 5200, 845000],
  'error'    => [0, 0, 0],
  'type'     => ['image/jpeg', 'image/png', 'application/pdf']
]

因此，必须先校验上传是否成功（error === 0），再逐个处理：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

// 获取上传文件数组（注意：必须用 [] 命名才能生成此结构）
$files = $_FILES['userImages'];
$name = $_POST['userName'] ?? '';
$email = $_POST['userEmail'] ?? '';

// 检查是否有文件且无错误
if (!isset($files['name']) || !is_array($files['name'])) {
    die("未检测到上传文件，请检查表单配置。");
}

$uploadedFiles = [];
for ($i = 0; $i  $files['name'][$i],
            'tmp_name' => $files['tmp_name'][$i],
            'size'     => $files['size'][$i],
            'type'     => $files['type'][$i]
        ];
    } else {
        // 可记录或跳过失败项（如 UPLOAD_ERR_NO_FILE）
        error_log("文件 {$i} 上传失败，错误码: {$files['error'][$i]}");
    }
}

✅ 构建支持多附件的 MIME 邮件

原代码仅处理单个附件，现需为每个文件生成独立的 MIME 段。关键点：

所有附件共享同一 boundary
每个附件段以 --{boundary} 开头
最终以 --{boundary}-- 结尾（注意结尾双横线）

// 基础邮件内容
$composition = "\r\n\n\nName: " . htmlspecialchars($name) .
               "\r\nEmail Address: " . htmlspecialchars($email);

$subject = "Form Submission";
$fromname = $name;
$fromemail = $email;
$mailto = 'recipient@example.com';

// 生成唯一 boundary
$separator = md5(uniqid(time()));
$eol = "\r\n";

$headers = "From: {$fromname} {$eol}";
$headers .= "MIME-Version: 1.0{$eol}";
$headers .= "Content-Type: multipart/mixed; boundary=\"{$separator}\"{$eol}";

$body = "--{$separator}{$eol}";
$body .= "Content-Type: text/plain; charset=\"utf-8\"{$eol}";
$body .= "Content-Transfer-Encoding: 8bit{$eol}{$eol}";
$body .= $composition . $eol;

// 逐个添加附件
foreach ($uploadedFiles as $file) {
    $content = file_get_contents($file['tmp_name']);
    if ($content === false) {
        error_log("无法读取临时文件: {$file['tmp_name']}");
        continue;
    }

    $encoded = chunk_split(base64_encode($content));

    $body .= "--{$separator}{$eol}";
    $body .= "Content-Type: {$file['type']}; name=\"{$file['name']}\"{$eol}";
    $body .= "Content-Transfer-Encoding: base64{$eol}";
    $body .= "Content-Disposition: attachment; filename=\"{$file['name']}\"{$eol}{$eol}";
    $body .= $encoded . $eol;
}

$body .= "--{$separator}--"; // 注意结尾双横线

// 发送邮件
if (mail($mailto, $subject, $body, $headers)) {
    header('Location: /formSent_confirmationPage.php');
    exit;
} else {
    die("邮件发送失败，请检查服务器配置。");
}

⚠️ 关键注意事项

表单 enctype 必须为 multipart/form-data：缺失将导致 $_FILES 为空；
PHP 配置限制：检查 upload_max_filesize、post_max_size 和 max_file_uploads（默认20），必要时在 php.ini 中调高；
安全过滤：对 $name 和 $email 使用 htmlspecialchars() 防止 XSS；对文件名建议重命名（如 uniqid() . '.' . pathinfo($file['name'], PATHINFO_EXTENSION)）避免路径遍历；
临时文件生命周期：$_FILES['tmp_name'] 在脚本结束时自动删除，务必在 mail() 前完成读取；
错误处理：始终检查 $_FILES['userImages']['error'] 数组值，区分 UPLOAD_ERR_OK、UPLOAD_ERR_NO_FILE 等状态。

通过以上改造，您的表单即可稳定支持多图上传并作为邮件附件发送。核心在于理解 $_FILES 的数组维度，并采用循环+MIME 多段结构实现可扩展附件处理。