PHP数据版本控制怎么实现

wen PHP项目 2026-07-10 208

本文目录导读：

PHP数据版本控制怎么实现

数据库记录变更追踪（类似审计日志）
文件/数据集的版本管理（类似 Git for Data）
实战建议

PHP 数据版本控制（Data Version Control）主要有两种场景：数据库记录变更追踪 和 文件/数据集的版本管理，下面分别介绍实现方案。

数据库记录变更追踪（类似审计日志）

数据库触发 + 历史表（最常用）

原理：为每个需要版本控制的表创建对应的 _history 表，使用触发器或应用层逻辑记录每次变更。

示例（MySQL + PHP）：

-- 原表
CREATE TABLE articles (
    id INT PRIMARY KEY AUTO_INCREMENT,VARCHAR(255),
    content TEXT,
    updated_at TIMESTAMP
);
-- 历史表（存储每次变更）
CREATE TABLE articles_history (
    history_id INT PRIMARY KEY AUTO_INCREMENT,
    article_id INT,VARCHAR(255),
    content TEXT,
    version INT,
    action ENUM('INSERT', 'UPDATE', 'DELETE'),
    changed_by VARCHAR(100),
    changed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

PHP 实现：

class VersionableModel {
    private $db;
    private $table;
    function save($data, $id = null) {
        if ($id) {
            // 1. 读取当前版本号
            $current = $this->db->query(
                "SELECT version FROM {$this->table} WHERE id = ?", [$id]
            )->fetch();
            // 2. 保存旧数据到历史表
            $this->db->query(
                "INSERT INTO {$this->table}_history (article_id, title, content, version, action, changed_by)
                 SELECT id, title, content, version, 'UPDATE', ?
                 FROM {$this->table} WHERE id = ?",
                [$_SESSION['user'], $id]
            );
            // 3. 更新原表
            $newVersion = $current['version'] + 1;
            $this->db->query(
                "UPDATE {$this->table} SET title=?, content=?, version=? WHERE id=?",
                [$data['title'], $data['content'], $newVersion, $id]
            );
        } else {
            // 新记录，版本号=1
            $this->db->query(
                "INSERT INTO {$this->table} (title, content, version) VALUES (?, ?, 1)",
                [$data['title'], $data['content']]
            );
            // 同时插入历史
            $newId = $this->db->lastInsertId();
            $this->db->query(
                "INSERT INTO {$this->table}_history (article_id, title, content, version, action, changed_by)
                 VALUES (?, ?, ?, 1, 'INSERT', ?)",
                [$newId, $data['title'], $data['content'], $_SESSION['user']]
            );
        }
    }
    // 获取某个版本
    function getVersion($id, $version) {
        return $this->db->query(
            "SELECT * FROM {$this->table}_history 
             WHERE article_id = ? AND version = ?",
            [$id, $version]
        )->fetch();
    }
}

JSON 快照存储（适合非结构数据）

将所有历史版本以 JSON 格式保存在单独的 versions 表：

class SnapshotVersion {
    private $table = 'entity_versions';
    function saveVersion($entityType, $entityId, $data) {
        $version = $this->getNextVersion($entityType, $entityId);
        $this->db->insert($this->table, [
            'entity_type' => $entityType,
            'entity_id'   => $entityId,
            'version'     => $version,
            'snapshot'    => json_encode($data),
            'created_by'  => current_user(),
            'created_at'  => date('Y-m-d H:i:s')
        ]);
    }
    function compareVersions($entityType, $entityId, $v1, $v2) {
        $data1 = json_decode($this->getVersion($entityType, $entityId, $v1)['snapshot'], true);
        $data2 = json_decode($this->getVersion($entityType, $entityId, $v2)['snapshot'], true);
        return array_diff_assoc($data1, $data2);
    }
}

使用现有 PHP 包（推荐）

Laravel Auditing：专为 Laravel 设计的审计日志，自动追踪所有模型变更。
Versionable：轻量级 PHP 库，支持回滚和版本比较。
Doctrine ORM：内置 Entity 版本控制（使用 @Version 注解）。

文件/数据集的版本管理（类似 Git for Data）

自建文件版本库

class FileVersionControl {
    private $repoPath;
    function commit($filePath, $message) {
        $hash = md5_file($filePath);
        $versionDir = $this->getVersionDir($filePath);
        // 1. 复制文件到版本目录
        copy($filePath, "$versionDir/$hash");
        // 2. 记录元信息
        $this->logCommit($filePath, $hash, $message);
    }
    function checkout($filePath, $versionHash) {
        $versionDir = $this->getVersionDir($filePath);
        $source = "$versionDir/$versionHash";
        if (file_exists($source)) {
            copy($source, $filePath);
        } else {
            throw new Exception("Version $versionHash not found");
        }
    }
    function diff($filePath, $v1, $v2) {
        $dir = $this->getVersionDir($filePath);
        return shell_exec("diff $dir/$v1 $dir/$v2");
    }
}

集成 DVC（Data Version Control）

DVC 是专为 ML 项目设计的数据版本控制工具，PHP 项目可通过命令行调用：

class DVCWrapper {
    function add($path) {
        exec("dvc add $path 2>&1", $output, $code);
        return $code === 0;
    }
    function commit($message) {
        exec("git add .dvc && git commit -m " . escapeshellarg($message));
    }
    function checkout($version) {
        exec("git checkout $version -- *.dvc");
        exec("dvc checkout");
    }
}

使用对象存储版本控制（S3/GCS）

class ObjectStoreVersions {
    private $s3;
    function save($bucket, $key, $data) {
        // 利用 S3 内置版本控制（需开启）
        $this->s3->putObject([
            'Bucket' => $bucket,
            'Key'    => $key,
            'Body'   => $data
        ]);
        // 自动生成 versionId
    }
    function listVersions($bucket, $key) {
        $versions = $this->s3->listObjectVersions([
            'Bucket' => $bucket,
            'Prefix' => $key
        ]);
        return $versions['Versions'];
    }
    function restore($bucket, $key, $versionId) {
        // 复制指定版本到当前版本
        $this->s3->copyObject([
            'Bucket'     => $bucket,
            'Key'        => $key,
            'CopySource' => "$bucket/$key?versionId=$versionId"
        ]);
    }
}

实战建议

| 场景 | 推荐方案 | 理由 | |------|----------|------|管理系统（CMS） | 历史表 + 触发器 | 简单可靠，SQL 查询方便 | | 电商订单变更 | JSON 快照 | 数据结构不固定，方便扩展 | | Team 协作的文章编辑 | Versionable 包 | 开箱即用，支持冲突检测 | | ML 数据集管理 | DVC | 针对大数据集优化，与 Git 配合 | | 文件服务器 | S3 版本控制 | 云原生，免维护 |

性能优化：