本文详解如何在 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 后端处理：扩展 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 < $total; $i++) {
$tmpPath = $_FILES['image']['tmp_name'][$i];
$fileName = basename($_FILES['image']['name'][$i]);
$filePath = $uploadDir . $fileName;
// 安全校验：非空、无错误、大小合理（示例：≤25MB）
if ($tmpPath && $_FILES['image']['error'][$i] === UPLOAD_ERR_OK
&& $_FILES['image']['size'][$i] <= 25 * 1024 * 1024) {
if (move_uploaded_file($tmpPath, $filePath)) {
$uploadedFiles[] = $filePath; // 记录成功上传路径
}
}
}
}
// ✅ 将所有成功上传的文件附加到邮件
if (!empty($uploadedFiles)) {
foreach ($uploadedFiles as $filePath) {
$pp->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）。
通过以上步骤，你的表单即可稳定支持多文件上传，并全部作为附件发送至指定邮箱。核心在于理解 $_FILES 的数组结构，并主动遍历处理——而非依赖单文件快捷方法。
