latrell/lock

支持Redis与Memcached的并发锁。

Maintainers

Details

github.com/Latrell/Lock

Source

Issues

Installs: 18 251

Dependents: 0

Suggesters: 0

Security: 0

Stars: 31

Watchers: 3

Forks: 9

1.6 2018-09-14 03:23 UTC

This package is not auto-updated.

Last update: 2022-06-23 10:05:34 UTC


README

这是一个支持 Laravel 5 的并发锁拓展包。

该模块在 Redis 与 Memcache 上实现了锁机制。

注意:集群环境下,必须使用 Redis 驱动,否则由于 Memcache 的特性,锁可能出现上锁不准确的情况。

安装

composer require latrell/lock dev-master

使用 composer update 更新包列表,或使用 composer install 安装。

找到 config/app.php 配置文件中的 providers 键,注册服务提供者。

(Laravel 5.5 以上版本可跳过该步骤)

    'providers' => [
        // ...
        Latrell\Lock\LockServiceProvider::class,
    ]

找到 config/app.php 配置文件中的 aliases 键,注册别名。

    'aliases' => [
        // ...
        'Lock' => Latrell\Lock\Facades\Lock::class,
    ]

运行 php artisan vendor:publish 命令,发布配置文件到你的项目中。

使用

闭包方式

使用闭包的方式,可由方法内自动处理异常,并自动解锁,防止死锁。

但需注意,外部变量需要使用 use 引入才可在闭包中使用。

// 防止商品超卖。
$key = 'Goods:' . $goods_id;
Lock::granule($key, function() use($goods_id) {
	$goods = Goods::find($goods_id);
	if ( $goods->stock > 0 ) {
		// ...
	}
});

普通方式

提供手动上锁与解锁方式,方便应用在复杂环境。

// 锁名称。
$key = 'Goods:' . $goods_id;

// **注意:除非特别自信,否则一定要记得捕获异常,保证解锁动作。**
try {

	// 上锁。
	Lock::acquire($key);

	// 逻辑单元。
	$goods = Goods::find($goods_id);
	if ( $goods->stock > 0 ) {
		// ...
	}
} finally {
	// 解锁。
	Lock::release($key);
}

中间件

使用中间件的方式,让两个相同指纹的请求同步执行。

找到 app/Http/Kernel.php 中的 $routeMiddleware 配置,添加中间件配置。

	protected $routeMiddleware = [
		// ...
		'synchronized' => \Latrell\Lock\Middleware\SynchronizationRequests::class,
	];