README

为Eloquent模型添加乐观锁功能。

安装

composer require reshadman/laravel-optimistic-locking

此包支持Laravel 5.5., 5.6., 5.7., 5.8., 6., 7. 和 8.x。

使用方法

基本使用

在你的模型中使用 \Reshadman\OptimisticLocking\OptimisticLocking 特性

<?php

class BlogPost extends Model {
    use OptimisticLocking;
}

并将整数 lock_version 字段添加到模型的表中

<?php

$schema->integer('lock_version')->unsigned()->nullable();

然后你就可以开始了，如果相同的资源被两个不同的进程 并发 编辑，则会抛出以下异常

<?php
\Reshadman\OptimisticLocking\StaleModelLockingException::class;

你应该捕获上述异常并根据您的业务逻辑正确处理。

在业务事务中维护lock_version

您可以在业务事务期间通过通知您的API或HTML客户端当前版本来跟踪锁版本

<input type="hidden" name="lock_version" value="{{$blogPost->lock_version}}" 

因此，如果有两位作者同时编辑相同的内容，您可以跟踪您的 读取状态，并要求第二位作者重新编写他的更改。

禁用和启用乐观锁

您可以禁用和启用特定实例的乐观锁

<?php
$blogPost->disableLocking();
$blogPost->enableLocking();

默认情况下，当您在模型中使用 OptimisticLocking 特性时，乐观锁是启用的，要更改默认行为，可以将锁定严格设置为 false

<?php
class BlogPost extends \Illuminate\Database\Eloquent\Model 
{
    use \Reshadman\OptimisticLocking\OptimisticLocking;
    
    protected $lock = false;
}

然后您可以启用它： $blogPost->enableLocking();

使用不同的列跟踪版本

默认情况下使用 lock_version 列跟踪版本，您可以通过覆盖特性的以下方法来更改此行为

<?php
class BlogPost extends \Illuminate\Database\Eloquent\Model
{
    use \Reshadman\OptimisticLocking\OptimisticLocking;
    
    /**
     * Name of the lock version column.
     *
     * @return string
     */
    protected static function lockVersionColumn()
    {
        return 'track_version';
    }
}

什么是乐观锁？

有关详细解释，请参阅 《企业应用架构模式》 中的并发部分。

有两种方法可以处理通用的并发竞争条件

1. 不允许其他进程（或用户）读取和更新相同的资源（悲观锁）
2. 允许其他进程并发读取同一资源，但如果在其中一个进程在其他人之前更新了资源，则不允许进一步更新（乐观锁）。

Laravel 允许使用文档中描述的悲观锁，此包允许您以类似 Rails 的方式实现乐观锁。

乐观锁期间会发生什么？

每次您对资源（模型）执行upsert操作时，表中的 lock_version 计数器字段都会增加 1，如果您读取了一个资源，并且另一个进程在您读取之后更新了该资源，则实际版本计数器会增加 1，如果当前进程尝试更新模型，则会抛出 StaleModelLockingException，您应根据您的业务逻辑处理竞争条件（合并、重试、忽略）。这可以通过向 乐观锁可用的模型 的更新查询中添加以下条件来完成

<?php
$query->where('id', $this->id)
    ->where('lock_version', $this->lock_version)
    ->update($changes);

如果资源在您的更新尝试之前已被更新，则上述操作将简单地更新 无 记录，这意味着模型在当前尝试之前已被更新或已被删除。

我们为什么不使用 updated_at 跟踪更改？

因为它们可能在两个并发更新期间保持不变。

运行测试

克隆存储库，执行 composer install 并运行

vendor/bin/phpunit

许可证

MIT许可证（MIT）。请参阅许可证文件以获取更多信息。