PHP PDO 实现单封面与多图上传教程
本教程详细介绍了如何使用HTML表单、PHP后端脚本和PDO数据库操作，实现同时上传一张封面图片和多张普通照片的功能。内容涵盖了前端表单的正确配置，后端$_FILES数组的处理技巧，以及如何将文件信息安全地存储到MySQL数据库中，帮助开发者构建高效的文件上传系统。
在现代web应用中，文件上传是一个常见而重要的功能。本教程将引导您完成一个场景，即在一个表单中同时上传一张专辑封面图片和多张专辑照片。我们将使用html构建表单，php处理服务器端逻辑，并通过pdo安全地将文件信息存储到mysql数据库。
1. HTML 表单结构设计
要实现文件上传功能，HTML表单需要正确配置。关键在于使用 enctype="multipart/form-data" 属性，它告诉浏览器表单数据中包含二进制文件
。对于多文件上传，input type="file" 元素还需要添加 multiple 属性，并且其 name 属性应以 [] 结尾，以便PHP将其识别为数组。
以下是实现单封面和多图上传的HTML表单示例：
专辑上传
在上述HTML中：
- action="upload.php" 指明表单数据将被发送到 upload.php 进行处理。
- name="cover_image" 用于上传单张封面图片。
- name="photos[]" 和 multiple 属性组合，允许用户选择多张图片，并在PHP中以数组形式接收。
- accept="image/*" 建议浏览器只允许选择图片文件，但这并非严格的安全措施，后端仍需验证。
2. PHP 后端文件处理与数据库存储
后端PHP脚本 upload.php 将负责接收上传的文件，将它们移动到服务器上的指定目录，并将文件路径及专辑信息存储到MySQL数据库。我们将使用PDO进行数据库操作，以提高安全性和灵活性。
数据库结构示例： 为了存储专辑信息和其关联的照片，我们可以创建两个表：albums 和 album_photos。
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
);
CREATE TABLE album_photos (
id INT AUTO_INCREMENT PRIMARY KEY,
album_id INT NOT NULL,
photo_path VARCHAR(255) NOT NULL,
FOREIGN KEY (album_id) REFERENCES albums(id) ON DELETE CASCADE,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);upload.php 示例代码：
setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
// 检查是否是POST请求
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
$albumName = trim($_POST['album_name'] ?? '');
// 验证专辑名称
if (empty($albumName)) {
throw new Exception('专辑名称不能为空。');
}
// --- 处理封面图片上传 ---
$coverImagePath = '';
if (isset($_FILES['cover_image']) && $_FILES['cover_image']['error'] === UPLOAD_ERR_OK) {
$coverFile = $_FILES['cover_image'];
// 验证文件类型和大小 (示例：只允许图片，最大5MB)
$allowedTypes = ['image/jpeg', 'image/png', 'image/gif'];
$maxFileSize = 5 * 1024 * 1024; // 5MB
if (!in_array($coverFile['type'], $allowedTypes)) {
throw new Exception('封面图片文件类型不被允许。');
}
if ($coverFile['size'] > $maxFileSize) {
throw new Exception('封面图片文件大小超过5MB。');
}
// 生成唯一文件名，防止覆盖和安全问题
$coverExtension = pathinfo($coverFile['name'], PATHINFO_EXTENSION);
$uniqueCoverName = uniqid('cover_') . '.' . $coverExtension;
$targetCoverPath = $uploadDir . $uniqueCoverName;
if (move_uploaded_file($coverFile['tmp_name'], $targetCoverPath)) {
$coverImagePath = $targetCoverPath;
} else {
throw new Exception('封面图片上传失败。');
}
} else if (!isset($_FILES['cover_image']) || $_FILES['cover_image']['error'] !== UPLOAD_ERR_NO_FILE) {
// 如果文件存在但有错误，或者根本没有文件但不是因为用户没有选择
throw new Exception('封面图片上传错误: ' . $_FILES['cover_image']['error']);
} else {
throw new Exception('请选择一张专辑封面。');
}
// --- 将专辑信息插入到 albums 表 ---
$pdo->beginTransaction(); // 开启事务
$stmt = $pdo->prepare("INSERT INTO albums (name, cover_path) VALUES (?, ?)");
$stmt->execute([$albumName, $coverImagePath]);
$albumId = $pdo->lastInsertId(); // 获取新插入专辑的ID
// --- 处理多张照片上传 ---
if (isset($_FILES['photos']) && is_array($_FILES['photos']['name'])) {
$totalPhotos = count($_FILES['photos']['name']);
$uploadedPhotoPaths = [];
for ($i = 0; $i < $totalPhotos; $i++) {
// 检查当前文件是否有上传错误
if ($_FILES['photos']['error'][$i] === UPLOAD_ERR_OK) {
$photoFile = [
'name' => $_FILES['photos']['name'][$i],
'type' => $_FILES['photos']['type'][$i],
'tmp_name' => $_FILES['photos']['tmp_name'][$i],
'error' => $_FILES['photos']['error'][$i],
'size' => $_FILES['photos']['size'][$i],
];
// 再次进行文件类型和大小验证
if (!in_array($photoFile['type'], $allowedTypes)) {
throw new Exception('照片文件类型不被允许: ' . $photoFile['name']);
}
if ($photoFile['size'] > $maxFileSize) {
throw new Exception('照片文件大小超过5MB: ' . $photoFile['name']);
}
// 生成唯一文件名
$photoExtension = pathinfo($photoFile['name'], PATHINFO_EXTENSION);
$uniquePhotoName = uniqid('photo_') . '.' . $photoExtension;
$targetPhotoPath = $uploadDir . $uniquePhotoName;
if (move_uploaded_file($photoFile['tmp_name'], $targetPhotoPath)) {
$uploadedPhotoPaths[] = $targetPhotoPath;
} else {
throw new Exception('照片上传失败: ' . $photoFile['name']);
}
} else if ($_FILES['photos']['error'][$i] !== UPLOAD_ERR_NO_FILE) {
// 如果文件存在但有错误
throw new Exception('照片上传错误: ' . $_FILES['photos']['name'][$i] . ' - 错误码: ' . $_FILES['photos']['error'][$i]);
}
}
// 将所有上传成功的照片路径插入到 album_photos 表
if (!empty($uploadedPhotoPaths)) {
$stmt = $pdo->prepare("INSERT INTO album_photos (album_id, photo_path) VALUES (?, ?)");
foreach ($uploadedPhotoPaths as $path) {
$stmt->execute([$albumId, $path]);
}
}
}
$pdo->commit(); // 提交事务
$message = '专辑及照片上传成功！';
$messageType = 'success';
} else {
$message = '非法请求方法。';
$messageType = 'error';
}
} catch (PDOException $e) {
if (isset($pdo) && $pdo->inTransaction()) {
$pdo->rollBack(); // 发生异常时回滚事务
}
$message = '数据库操作失败: ' . $e->getMessage();
$messageType = 'error';
// 实际应用中应记录到日志而非直接显示给用户
} catch (Exception $e) {
if (isset($pdo) && $pdo->inTransaction()) {
$pdo->rollBack(); // 发生异常时回滚事务
}
$message = '上传失败: ' . $e->getMessage();
$messageType = 'error';
}
?>
上传结果
">
返回上传页
在上述PHP代码中：
- 数据库连接：使用PDO建立到MySQL数据库的连接，并设置错误模式为异常，以便捕获和处理数据库错误。
- 文件上传目录：定义一个 uploads/ 目录来存储上传的文件，并确保该目录存在且可写。
- 处理专辑名称：从 $_POST 获取专辑名称并进行基本验证。
-
处理封面图片：
- 通过 $_FILES['cover_image'] 访问上传的封面文件信息。
- 进行文件类型和大小的基本验证。
- 生成一个唯一的随机文件名，以防止文件名冲突和潜在的安全风险。
- 使用 move_uploaded_file() 函数将临时文件移动到目标目录。
-
处理多张照片：
- $_FILES['photos'] 会是一个包含多个文件的信息数组。$_FILES['photos']['name']、$_FILES['photos']['type'] 等都将是数组。
- 通过循环遍历 $_FILES['photos']['name'] 数组来处理每个上传的文件。
- 对每个文件执行与封面图片相同的验证和移动操作。
- 数据库事务：使用 beginTransaction()、commit() 和 rollBack() 来确保专辑信息和所有照片路径要么全部成功插入，要么全部失败回滚，维护数据一致性。
- 错误处理：使用 try-catch 块捕获可能发生的 PDOException 和自定义 Exception，并在发生错误时回滚事务并向用户显示友好的错误消息。
-
安全考虑：
- 文件名：使用 uniqid() 生成唯一文件名，而不是直接使用用户上传的文件名，防止路径遍历攻击和文件覆盖。
- 文件类型和大小：在后端严格验证文件类型和大小，防止上传恶意文件或过大的文件导致服务器资源耗尽。accept 属性仅是前端提示，不应作为安全保障。
- 目录权限：确保上传目录权限设置正确（例如 0755 或 0777，但生产环境中 0777 需谨慎），防止未经授权的访问。
3. 关键注意事项
- 文件上传目录权限：确保PHP进程对 $uploadDir 目录具有写入权限。在Linux系统上，您可能需要使用 chmod 755 uploads/ 或 chmod 777 uploads/（后者权限过高，仅在开发环境测试时使用）。
- PHP 配置：检查 php.ini 中的 upload_max_filesize 和 post_max_size 设置，确保它们足够大以允许上传您的文件。对于多文件上传，还需注意 max_file_uploads。
- 错误信息：$_FILES['file']['error'] 提供了上传过程中发生的具体
