想象一下，你负责维护一个内容管理系统，编辑们每天都在更新文章、产品描述等核心数据。突然有一天，一位编辑不小心删改了一段关键内容，或者客户要求查看某个产品在半年前的描述是什么样子。面对这些场景，你是否感到头疼？
传统的做法可能是手动记录日志、创建复杂的审计表，或者干脆祈祷这种事情不要发生。但这些方法不仅开发成本高昂，而且维护起来也十分困难，容易遗漏关键信息，甚至在紧急情况下无法快速回溯。
幸运的是，在 PHP 生态中，我们有 Composer 这个强大的依赖管理工具，它为我们带来了无数优秀的开源解决方案。而针对 Laravel 模型的版本控制需求，
包简直是救星。它提供了一种简洁、高效的方式，让你能够轻松地追踪模型的所有变更，并随时回溯到任何一个历史版本。
Composer在线学习地址：
学习地址
：Laravel 模型版本控制的利器
是一个专为 Laravel 设计的包，它允许你为任何 Eloquent 模型添加版本控制功能。这意味着，每次你更新模型时，它都会自动保存一份旧版本的快照，让你能够随时查看、比较甚至恢复到之前的状态。
核心优势一览：
自动追踪：
无需手动编写复杂的逻辑，只需简单配置即可自动保存模型变更。
轻松回溯：
提供直观的方法，让你一键回滚到前一个版本或指定版本。
版本比较：
能够对比不同版本之间的差异，清晰展示数据变动。
灵活配置：
支持排除不需要版本控制的字段，限制存储的版本数量，甚至使用自定义版本表。
如何使用
使用
非常简单，遵循以下几个步骤即可：
1. 安装
首先，通过 Composer 将包安装到你的 Laravel 项目中：
2. 运行迁移
安装完成后，你需要运行包提供的数据库迁移，以创建存储版本信息的表。你可以选择直接运行，或者发布迁移文件进行自定义。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
直接运行迁移：
发布并自定义迁移（推荐）：
发布迁移文件后，你可以在
目录下找到它，并根据需要进行修改。
3. 在模型中使用 Trait
现在，为你想要进行版本控制的 Eloquent 模型添加
。
就是这么简单！
从现在开始，每次你更新
模型时，
都会自动创建一个新的版本记录，保存更新前的模型状态。
实际应用与高级功能
创建初始版本：
如果你在现有项目中使用，可能需要为已有的数据创建第一个版本：
排除不需版本控制的字段：
有些字段（如
）频繁变动，但我们通常不希望它们触发新版本创建。你可以在模型中定义
属性来排除它们：
限制存储的版本数量：
为了避免版本表无限增长，你可以限制每个模型保留的最大版本数量：
回溯到历史版本：
这是版本控制最核心的功能。你可以轻松地回滚到上一个版本或指定版本：
查看所有版本与版本差异：
你可以像访问普通关联关系一样，获取模型的所有历史版本：
临时禁用版本控制：
在某些特定操作中，你可能不希望创建版本。可以使用
和
方法：
总结
包为 Laravel 开发者提供了一个强大而优雅的模型版本控制解决方案。它将你从繁琐的手动记录和回溯工作中解放出来，带来了以下显著优势：
数据安全性提升：
告别因误操作导致的数据丢失，随时可以恢复到正确状态。
审计追踪完善：
每一项变更都有据可查，轻松满足合规性要求。
开发效率提高：
无需重复造轮子，专注于业务逻辑，将版本控制交给专业工具。
用户体验优化：
为你的应用增加“撤销”和“历史记录”功能，提升用户信心。
如果你正在寻找一个可靠的 Laravel 模型版本控制方案，那么
绝对值得一试。它将为你的项目带来稳定性和可维护性的巨大提升。
mpociot/versionablempociot/versionablempociot/versionablempociot/versionablempociot/versionablecomposer require mpociot/versionablephp artisan migrate --path=vendor/mpociot/versionable/src/migrationsphp artisan vendor:publish --provider="Mpociot\Versionable\Providers\ServiceProvider" --tag="migrations"
php artisan migratedatabase/migrationsVersionableTraitArticlempociot/versionable$article = Article::find(1);
$article->createInitialVersion(); // 为单个模型创建初始版本
// 或者为所有模型实例创建初始版本
Article::initializeVersions();last_login_at$dontVersionFieldsclass User extends Model
{
use VersionableTrait;
protected $dontVersionFields = [
'last_login_at',
'updated_at' // 通常时间戳也不需要版本化
];
}class Article extends Model
{
use VersionableTrait;
protected $keepOldVersions = 10; // 只保留最新的10个版本
}$article = Article::find(1);
// 回溯到上一个版本
$article->previousVersion()->revert();
// 回溯到特定版本ID
// 假设 Version::find(5) 是你想要回溯的版本
$revertedArticle = \Mpociot\Versionable\Version::find(5)->revert();$article = Article::find(1);
foreach ($article->versions as $version) {
echo "版本 ID: {$version->id}, 创建时间: {$version->created_at}\n";
// $version->getModel() 可以获取该版本对应的模型实例
}
// 比较两个版本之间的差异
$currentVersion = $article->currentVersion(); // 获取当前版本的记录
$previousVersion = $article->previousVersion(); // 获取上一个版本的记录
if ($previousVersion) {
$diff = $currentVersion->diff($previousVersion);
dump($diff); // 输出一个数组，包含变动的字段及其新旧值
}disableVersioning()enableVersioning()$article = Article::find(1);
$article->disableVersioning();
// 这次更新将不会创建新的版本记录
$article->update(['title' => '临时修改的标题']);
$article->enableVersioning(); // 重新启用版本控制mpociot/versionablempociot/versionable