1. 问题背景与传统方法局限
在Web开发中，用户经常需要上传多个文件，例如头像和演示文稿。传统上，我们可能会为每个文件输入字段设置独立的name属性，如name="displaypic"和name="presentation"。虽然这种方式在PHP中可以分别通过$_FILES['displaypic']和$_FILES['presentation']来访问，但当文件数量增多时，代码会变得冗余且难以维护。更重要的是，如果两个文件字段的name属性被错误地设置为相同的值，PHP只会处理第一个同名文件字段的上传，导致后续文件被忽略。
2. 解决方案：HTML表单的数组式命名
为了更优雅地处理多个文件上传，我们应该在HTML表单中使用数组式命名（Array-Style Naming）。这意味着所有相关的文件输入字段都使用一个共同的父name，并通过方括号中的标识符来区分它们。
例如，将name="displaypic"和name="presentation"改为name="xfiles[displaypic]"和name="xfiles[presentation]"。这里的xfiles是所有文件的一个逻辑分组名，而displaypic和presentation则是这个组内的具体文件标识符。
以下是修改后的HTML表单示例：
立即学习“PHP免费学习笔记（深入）”；
关键点：
- enctype="multipart/form-data"：这是处理文件上传的必需属性。
- name="xfiles[identifier]"：这是实现多文件统一处理的关键。
3. PHP后端文件处理逻辑
当表单以数组式命名提交后，PHP的$_FILES超全局变量将以不同的结构组织数据。例如，$_FILES['xfiles']将是一个包含所有上传文件详细信息的数组，其结构如下：
$_FILES['xfiles'] = [
'name' => [
'displaypic' => 'avatar.jpg',
'presentation' => 'report.pptx'
],
'type' => [
'displaypic' => 'image/jpeg',
'presentation' => 'application/vnd.openxmlformats-officedocument.presentationml.presentation'
],
'tmp_name' => [
'displaypic' => '/tmp/phpXYZ.tmp',
'presentation' => '/tmp/phpABC.tmp'
],
'error' => [
'displaypic' => 0, // UPLOAD_ERR_OK
'presentation' => 0
],
'size' => [
'displaypic' => 123456,
'presentation' => 7890123
]
];我们可以通过遍历$_FILES['xfiles']['name']来逐一处理每个上传的文件。
以下是完整的PHP处理代码示例：
[
'extensions' => ['jpg', 'jpeg', 'png'],
'max_size' => 2 * 1024 * 1024 // 2MB
],
'presentation' => [
'extensions' => ['ppt', 'pptx'],
'max_size' => 10 * 1024 * 1024 // 10MB
]
];
// 遍历每个上传的文件（通过其标识符）
foreach ($uploadedFiles['name'] as $identifier => $fileName) {
// 获取当前文件的所有属性
$tmpName = $uploadedFiles['tmp_name'][$identifier];
$error = $uploadedFiles['error'][$identifier];
$size = $uploadedFiles['size'][$identifier];
$fileType = $uploadedFiles['type'][$identifier];
// 获取文件扩展名
$fileExt = strtolower(pathinfo($fileName, PATHINFO_EXTENSION));
// 验证当前标识符是否存在于允许的文件类型配置中
if (!isset($allowedFileTypes[$identifier])) {
$uploadErrors[] = "未知文件类型标识符: " . htmlspecialchars($identifier);
continue; // 跳过此文件
}
$currentAllowed = $allowedFileTypes[$identifier];
// 1. 检查上传错误
if ($error !== UPLOAD_ERR_OK) {
$uploadErrors[] = sprintf("文件 %s (标识符: %s) 上传失败，错误码: %d。",
htmlspecialchars($fileName), htmlspecialchars($identifier), $error);
continue;
}
// 2. 检查文件扩展名
if (!in_array($fileExt, $currentAllowed['extensions'])) {
$uploadErrors[] = sprintf("文件 %s (标识符: %s) 的扩展名不被允许。允许的扩展名: %s。",
htmlspecialchars($fileName), htmlspecialchars($identifier), implode(', ', $currentAllowed['extensions']));
continue;
}
// 3. 检查文件大小
if ($size > $currentAllowed['max_size']) {
$uploadErrors[] = sprintf("文件 %s (标识符: %s) 过大。允许的最大大小: %s。",
htmlspecialchars($fileName), htmlspecialchars($identifier), formatBytes($currentAllowed['max_size']));
continue;
}
// 4. 生成唯一文件名，防止覆盖
$newFileName = uniqid('upload_', true) . '.' . $fileExt;
$destinationPath = $uploadDir . $newFileName;
// 5. 移动上传文件
if (move_uploaded_file($tmpName, $destinationPath)) {
$uploadStatus[] = sprintf("文件 %s (标识符: %s) 上传成功，保存为: %s。",
htmlspecialchars($fileName), htmlspecialchars($identifier), htmlspecialchars($newFileName));
// 可以在这里将文件信息保存到数据库
// 例如：$sql = "INSERT INTO files (original_name, stored_name, identifier, size, type) VALUES (?, ?, ?, ?, ?)";
// 执行SQL语句...
} else {
$uploadErrors[] = sprintf("文件 %s (标识符: %s) 移动失败。",
htmlspecialchars($fileName), htmlspecialchars($identifier));
}
}
}
// 辅助函数：格式化字节大小
function formatBytes($bytes, $precision = 2) {
$units = array('B', 'KB', 'MB', 'GB', 'TB');
$bytes = max($bytes, 0);
$pow = floor(($bytes ? log($bytes) : 0) / log(1024));
$pow = min($pow, count($units) - 1);
$bytes /= (1 << (10 * $pow));
return round($bytes, $precision) . ' ' . $units[$pow];
}
?>
PHP 多文件上传教程
