PHP与MySQL实现单表单多文件上传：封面与多图集管理教程_技术教程

本教程详细阐述如何在单个HTML表单中同时上传一个封面图片和多张照片到服务器，并使用PHP处理文件上传逻辑，结合PDO与MySQL进行数据存储。内容涵盖前端表单构建、后端文件接收与移动、数据库设计与交互，并强调了多文件上传的关键设置name="photos[]" multiple，以及文件类型、大小限制、安全性等最佳实践。

1. 概述：单表单多文件上传的需求与挑战

在Web开发中，经常会遇到需要用户在同一个表单中上传不同类型或数量文件的场景，例如创建一个相册时，需要上传一张封面图和多张内页照片。这种需求的关键在于如何正确构建HTML表单，以及如何在服务器端（PHP）准确接收并处理这些不同类型的文件。本教程将深入探讨如何利用HTML5的multiple属性和PHP的$_FILES超全局变量来高效实现这一功能，并结合MySQL数据库进行文件路径的存储。

2. HTML表单构建：支持单文件与多文件上传

要实现单表单内的多文件上传，HTML表单需要进行特定配置。最重要的是设置enctype="multipart/form-data"，这是处理文件上传的必需属性。对于多文件选择，需要将input type="file"元素的name属性设置为数组形式（例如name="photos[]"），并添加multiple属性。


  选择相册封面:
  

  选择多张照片:
  

  相册名称:

关键点解析：

enctype="multipart/form-data": 告诉浏览器表单数据将包含文件，以便正确编码。
name="cover": 用于上传单张封面图片，其name属性是普通的字符串。
name="photos[]" multiple:
- multiple: 允许用户选择多个文件。
- name="photos[]": 这是PHP能够将所有选定的文件作为一个数组来处理的关键。当表单提交时，$_FILES['photos']将是一个包含所有上传文件信息的数组。
accept="image/*": 这是一个可选但推荐的属性，它提示浏览器只允许选择图片文件，提升用户体验。

3. MySQL数据库设计

为了存储相册信息及其关联的图片，我们可以设计两个表：albums（相册）和photos（照片）。

albums 表结构示例：

CREATE TABLE `albums` (
    `id` INT AUTO_INCREMENT PRIMARY KEY,
    `name` VARCHAR(255) NOT NULL,
    `cover_path` VARCHAR(255) NOT NULL,
    `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

photos 表结构示例：

CREATE TABLE `photos` (
    `id` INT AUTO_INCREMENT PRIMARY KEY,
    `album_id` INT NOT NULL,
    `photo_path` VARCHAR(255) NOT NULL,
    `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (`album_id`) REFERENCES `albums`(`id`) ON DELETE CASCADE
);

4. PHP服务器端处理：文件上传与数据库存储

PHP通过$_FILES超全局变量来接收上传的文件。对于单文件上传，$_FILES['name']是一个字符串；对于多文件上传（使用了name="photos[]"），$_FILES['photos']将是一个关联数组，其内部的name、type、tmp_name、error、size等属性本身也是数组。

以下是一个完整的PHP处理脚本示例，它使用PDO连接MySQL数据库，并处理文件上传。

setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    $pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
} catch (PDOException $e) {
    die("数据库连接失败: " . $e->getMessage());
}

// 2. 设置上传目录
$uploadDir = 'uploads/'; // 确保此目录存在且PHP有写入权限
$coverUploadDir = $uploadDir . 'covers/';
$photosUploadDir = $uploadDir . 'photos/';

// 确保上传目录存在
if (!is_dir($coverUploadDir)) {
    mkdir($coverUploadDir, 0777, true);
}
if (!is_dir($photosUploadDir)) {
    mkdir($photosUploadDir, 0777, true);
}

// 3. 处理表单提交
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $albumName = trim($_POST['nameAlbum']);
    $coverPath = '';
    $photoPaths = [];

    // 验证相册名称
    if (empty($albumName)) {
        echo "相册名称不能为空。
";
        exit;
    }

    // 4. 处理封面图片上传 (单文件)
    if (isset($_FILES['cover']) && $_FILES['cover']['error'] === UPLOAD_ERR_OK) {
        $coverTmpName = $_FILES['cover']['tmp_name'];
        $coverFileName = basename($_FILES['cover']['name']);
        $coverTargetFile = $coverUploadDir . uniqid() . '_' . $coverFileName; // 使用uniqid生成唯一文件名

        // 移动上传文件
        if (move_uploaded_file($coverTmpName, $coverTargetFile)) {
            $coverPath = $coverTargetFile;
        } else {
            echo "封面图片上传失败。
";
            exit;
        }
    } else {
        echo "请选择封面图片。
";
        exit;
    }

    // 5. 插入相册信息到数据库，获取相册ID
    try {
        $stmt = $pdo->prepare("INSERT INTO albums (name, cover_path) VALUES (?, ?)");
        $stmt->execute([$albumName, $coverPath]);
        $albumId = $pdo->lastInsertId();
        echo "相册 '" . htmlspecialchars($albumName) . "' 创建成功，ID: " . $albumId . "
";
    } catch (PDOException $e) {
        echo "创建相册失败: " . $e->getMessage() . "
";
        // 如果相册创建失败，需要删除已上传的封面文件
        if (file_exists($coverPath)) {
            unlink($coverPath);
        }
        exit;
    }

    // 6. 处理多张照片上传 (多文件)
    if (isset($_FILES['photos']) && is_array($_FILES['photos']['name'])) {
        $totalPhotos = count($_FILES['photos']['name']);
        $uploadedCount = 0;

        for ($i = 0; $i < $totalPhotos; $i++) {
            // 检查每个文件的上传状态
            if ($_FILES['photos']['error'][$i] === UPLOAD_ERR_OK) {
                $photoTmpName = $_FILES['photos']['tmp_name'][$i];
                $photoFileName = basename($_FILES['photos']['name'][$i]);
                $photoTargetFile = $photosUploadDir . uniqid() . '_' . $photoFileName; // 唯一文件名

                if (move_uploaded_file($photoTmpName, $photoTargetFile)) {
                    $photoPaths[] = $photoTargetFile;
                    $uploadedCount++;

                    // 插入每张照片的信息到数据库
                    try {
                        $stmt = $pdo->prepare("INSERT INTO photos (album_id, photo_path) VALUES (?, ?)");
                        $stmt->execute([$albumId, $photoTargetFile]);
                    } catch (PDOException $e) {
                        echo "照片 '" . htmlspecialchars($photoFileName) . "' 存储失败: " . $e->getMessage() . "
";
                        // 即使数据库存储失败，文件可能已上传，可以考虑删除或记录日志
                        if (file_exists($photoTargetFile)) {
                            unlink($photoTargetFile);
                        }
                    }
                } else {
                    echo "照片 '" . htmlspecialchars($photoFileName) . "' 上传失败。
";
                }
            } else if ($_FILES['photos']['error'][$i] !== UPLOAD_ERR_NO_FILE) {
                // 排除没有选择文件的情况
                echo "照片上传错误 (文件: " . htmlspecialchars($_FILES['photos']['name'][$i]) . ", 错误码: " . $_FILES['photos']['error'][$i] . ")。
";
            }
        }
        echo "成功上传 " . $uploadedCount . " 张照片。
";
    } else {
        echo "没有选择任何照片或照片上传出错。
";
    }

    echo "所有文件处理完毕。
";
}
?>

代码解析：

数据库连接: 使用PDO进行数据库连接，确保安全性与健壮性。
上传目录: 定义并创建了两个独立的上传目录，一个用于封面，一个用于多张照片，有助于文件管理。
封面图片处理:
- 通过$_FILES['cover']访问封面文件信息。
- move_uploaded_file()函数将临时文件移动到指定的目标目录。
- 使用uniqid()函数生成唯一的文件名，防止文件名冲突。
相册信息插入: 先将相册名称和封面路径插入albums表，并获取新插入的album_id，这是关联多张照片的关键。
多张照片处理:
- $_FILES['photos']['name']是一个数组，通过count()获取文件数量，然后循环遍历处理每个文件。
- 在循环内部，$_FILES['photos']['tmp_name'][$i]、$_FILES['photos']['name'][$i]等用于访问当前文件的临时路径和原始文件名。
- 同样使用move_uploaded_file()将每张照片移动到目标目录。
- 将每张照片的路径和对应的album_id插入到photos表中。
错误处理: 检查$_FILES['error']属性可以获取文件上传过程中的错误信息，如文件过大、部分上传等。UPLOAD_ERR_OK表示上传成功。

5. 注意事项与最佳实践

安全性:
- 文件类型验证: 除了前端的accept属性，后端也必须验证文件类型（MIME Type），防止上传恶意脚本。可以使用finfo_open()或getimagesize()来检查文件真实类型，而不是仅仅依赖文件扩展名。
- 文件大小限制: 在PHP配置 (php.ini) 中设置upload_max_filesize和post_max_size，并在代码中再次检查文件大小。
- 唯一文件名: 始终使用uniqid()、md5()或时间戳等方式生成唯一文件名，避免覆盖现有文件和路径遍历攻击。
- 上传目录权限: 确保上传目录具有写入权限（例如0755或0777），但不要将PHP脚本放在可直接访问的上传目录中。
错误处理: 完善move_uploaded_file()的返回值检查和$_FILES['error']的错误码判断，为用户提供清晰的反馈。
用户体验:
- 提供文件上传进度条（通常需要JavaScript配合）。
- 明确告知用户允许上传的文件类型和大小限制。
- 上传成功或失败后给出明确的提示信息。
资源管理: 如果上传失败或数据库插入失败，应及时删除已上传的临时文件，避免服务器空间浪费。
路径存储: 数据库中只存储文件的相对路径或绝对URL，而不是文件本身。这样可以灵活地在不同环境中使用。

总结

通过本教程，我们学习了如何构建一个能够同时处理单文件（封面）和多文件（照片集）上传的HTML表单，并使用PHP结合PDO和MySQL进行服务器端的文件接收、存储和数据库记录。理解name="photos[]" multiple在HTML中的作用以及$_FILES在PHP中对单文件和多文件的不同处理方式是实现此功能的关键。同时，遵循安全性、错误处理和用户体验的最佳实践，将确保您的文件上传功能既强大又健壮。