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

如何在 PHP 表单中正确实现多文件上传

本文详解如何在 html 表单中支持多文件选择，并在 php 后端（含 formhandler 库）完整接收、验证与保存多个上传文件，解决仅收到单个文件的常见问题。

本文详解如何在 html 表单中支持多文件选择，并在 php 后端（含 formhandler 库）完整接收、验证与保存多个上传文件，解决仅收到单个文件的常见问题。

在 Web 表单中启用多文件上传，不仅需要前端 <input type="file" multiple> 的正确配置，更关键的是后端必须显式遍历 $_FILES 数组——因为浏览器会将多个文件以数组形式提交到同一名字的字段下（如 name="image[]" 或 name="image"），而默认的单文件处理逻辑（如 $pp->attachFiles(['image'])）仅取第一个元素，导致其余文件被忽略。

✅ 正确的 HTML 结构（关键修改）

首先，确保文件输入字段使用数组命名语法（推荐），并保留 multiple 属性：

<input type="file" class="form-control" id="image" name="image[]" multiple required>

⚠️ 注意：name="image[]" 是核心！它使 PHP 将所有选中文件组织为 $_FILES['image'] 的多维数组，而非覆盖式单值。若沿用 name="image"，虽能触发多选，但 $_FILES['image']['name'] 会是字符串（仅首文件），无法安全遍历。

✅ JavaScript 提交适配（保持 FormData 兼容性）

你当前的 FormData(this) 已正确支持多文件上传，无需修改。jQuery AJAX 配置（processData: false, contentType: false）也完全正确，可保留。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

✅ PHP 后端处理：扩展 FormHandler 的多文件支持

原代码中 $pp->attachFiles(['image']) 仅绑定单个文件。要支持多文件，需绕过自动附件机制，手动处理 $_FILES['image'] 并附加至邮件。以下是兼容 FormHandler v2+ 的完整解决方案：

<?php ini_set('display_errors', 1);
error_reporting(E_ALL);
require_once './vendor/autoload.php';

use FormGuide\Handlx\FormHandler;

$pp = new FormHandler();
$validator = $pp->getValidator();

// 基础字段验证（保持不变）
$validator->fields(['name','email'])->areRequired()->maxLength(50);
$validator->field('email')->isEmail();
$validator->field('message')->maxLength(6000);

// ❌ 移除原 attachFiles 调用（它不支持多文件）
// $pp->attachFiles(['image']);

// ✅ 手动处理多文件上传
$uploadedFiles = [];
if (!empty($_FILES['image']['name'])) {
    $total = count($_FILES['image']['name']);
    $uploadDir = __DIR__ . '/uploads/'; // 确保目录存在且可写

    if (!is_dir($uploadDir)) {
        mkdir($uploadDir, 0755, true);
    }

    for ($i = 0; $i addAttachment($filePath); // FormHandler v2.3+ 支持多次调用
    }
}

$pp->sendEmailTo('your-email@example.com');
echo $pp->process($_POST);

? 关键注意事项

命名一致性：HTML 的 name="image[]" 必须与 PHP 中 $_FILES['image'] 的键名严格一致；
目录权限：确保 uploads/ 目录存在、Web 服务器用户有写入权限（Linux 常用 chmod 755）；
安全加固：生产环境应增加 MIME 类型校验（finfo_file()）、文件扩展名白名单、病毒扫描等；
错误处理：$_FILES['image']['error'][$i] 需逐个检查，UPLOAD_ERR_OK（0）才表示成功；
内存限制：PHP 的 upload_max_filesize 和 post_max_size 需设为 ≥ 单文件最大值 × 文件数（如 25MB × 5 = 125MB）。