PHP 8.1上传文件下载怎么实现上传文件版本管理？版本控制教程-php教程-PHP中文网

php 8.1 不内置文件版本管理，需开发者通过不覆盖原文件、记录元数据、提供版本接口实现；核心是哈希+时间戳命名存储、file_versions表维护版本信息、上传时更新is_current标记，并支持按版本下载与回滚。

php 8.1上传文件下载怎么实现上传文件版本管理？版本控制教程

PHP 8.1 本身不内置文件版本管理功能，上传文件的“版本控制”需由开发者结合业务逻辑、存储策略与元数据设计来实现。它不是 Git 那样的代码级版本系统，而是指：同一文件名多次上传时，保留历史版本、支持回滚、标记时间/用户/变更说明，并能按需下载指定版本。

核心思路是：不覆盖原文件 + 记录版本元数据 + 提供版本索引接口。

一、基础版本存储结构设计

每次上传同名文件时，不直接覆盖，而是生成唯一标识并保存为带版本后缀或独立路径的文件：

✅ 推荐方式：用哈希+时间戳命名（防重+可追溯）
report.pdf → report_20260922153022_abc123.pdf
其中 abc123 是文件内容 MD5 或 SHA256 前6位（用于秒传和去重）
✅ 可选方式：按版本号递增目录存储
/uploads/report.pdf/v1/, /uploads/report.pdf/v2/, /uploads/report.pdf/v3/
❌ 避免：仅靠数据库记录路径但物理文件被覆盖 —— 失去版本实质意义

二、数据库记录版本元信息（必需）

建一张 file_versions 表，关键字段包括：

PHP

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

下载

CREATE TABLE file_versions (
  id BIGINT PRIMARY KEY AUTO_INCREMENT,
  original_name VARCHAR(255) NOT NULL,   -- 原始文件名，如 "合同.pdf"
  stored_name VARCHAR(255) NOT NULL,      -- 实际保存名，如 "合同_20260922153022_a1b2c3.pdf"
  path VARCHAR(512) NOT NULL,             -- 完整相对路径，如 "/uploads/2026/09/合同_20260922153022_a1b2c3.pdf"
  size INT UNSIGNED NOT NULL,
  mime_type VARCHAR(128),
  uploader_id INT,                        -- 上传人ID（可关联用户表）
  upload_time DATETIME DEFAULT CURRENT_TIMESTAMP,
  version_note TEXT,                      -- 版本说明，如“终稿V2，法务修订”
  is_current TINYINT(1) DEFAULT 1,        -- 是否为当前最新版（便于快速查最新）
  md5_hash CHAR(32)                       -- 用于秒传和冲突检测
);

上传成功后，将旧版本 is_current 设为 0，新版本设为 1。

三、PHP 8.1 后端上传与版本写入示例

// 1. 接收文件
if ($_FILES['file']['error'] === UPLOAD_ERR_OK) {
    $originalName = $_FILES['file']['name'];
    $tmpPath = $_FILES['file']['tmp_name'];
    $size = $_FILES['file']['size'];
    $mime = $_FILES['file']['type'];

    // 2. 计算内容哈希（确保不依赖临时文件残留）
    $content = file_get_contents($tmpPath);
    $hash = substr(md5($content), 0, 6);
    $timestamp = date('YmdHis');
    $storedName = pathinfo($originalName, PATHINFO_FILENAME) 
                 . '_' . $timestamp . '_' . $hash 
                 . '.' . pathinfo($originalName, PATHINFO_EXTENSION);

    $uploadDir = '/www/wwwroot/myapp/uploads/' . date('Y/m');
    if (!is_dir($uploadDir)) mkdir($uploadDir, 0755, true);

    $fullPath = $uploadDir . '/' . $storedName;
    if (move_uploaded_file($tmpPath, $fullPath)) {
        // 3. 写入数据库（PDO 示例）
        $pdo->prepare("
            INSERT INTO file_versions (original_name, stored_name, path, size, mime_type, uploader_id, version_note, md5_hash)
            VALUES (?, ?, ?, ?, ?, ?, ?, ?)
        ")->execute([
            $originalName,
            $storedName,
            str_replace($_SERVER['DOCUMENT_ROOT'], '', $fullPath),
            $size,
            $mime,
            $_SESSION['user_id'] ?? null,
            $_POST['version_note'] ?? '',
            md5($content)
        ]);

        // 4. 更新当前版本标记（原子操作）
        $pdo->exec("UPDATE file_versions SET is_current = 0 WHERE original_name = '$originalName' AND id != LAST_INSERT_ID()");
    }
}

⚠️ 注意：生产环境请用预处理语句防注入，且 md5(file_get_contents()) 仅适用于中小文件；超大文件需流式计算哈希（如 hash_init('md5') + hash_update_stream()）。

四、前端与下载版本选择逻辑

列出所有版本（按 upload_time DESC）：

$stmt = $pdo->prepare("SELECT * FROM file_versions WHERE original_name = ? ORDER BY upload_time DESC");
$stmt->execute([$filename]);
$versions = $stmt->fetchAll();

下载指定版本（通过 id 或 stored_name）：

// download.php?id=123
$stmt = $pdo->prepare("SELECT path FROM file_versions WHERE id = ?");
$stmt->execute([$_GET['id']]);
$row = $stmt->fetch();
if ($row && file_exists($_SERVER['DOCUMENT_ROOT'] . $row['path'])) {
    $realPath = $_SERVER['DOCUMENT_ROOT'] . $row['path'];
    $originalName = basename($row['path']); // 或从DB查 original_name
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename="' . $originalName . '"');
    header('Content-Length: ' . filesize($realPath));
    readfile($realPath);
    exit;
}