README

关于

ninja-mutex 是一个简单易用的 PHP 互斥锁实现。它支持不同的适配器（flock、memcache、mysql、redis、...），因此您可以按照自己的意愿进行设置。所有适配器（如果设置正确）都可以在多服务器环境中使用 - 换句话说，锁在 web 服务器之间是共享的。

使用方法

互斥锁

首先，您需要选择适配器并正确设置它。例如，如果您选择 flock 实现，首先需要设置 NFS 文件系统并将其挂载在 web 服务器上。在本例中，我们将选择 memcache 适配器。

<?php
require 'vendor/autoload.php';

use NinjaMutex\Lock\MemcacheLock;
use NinjaMutex\Mutex;

$memcache = new Memcache();
$memcache->connect('127.0.0.1', 11211);
$lock = new MemcacheLock($memcache);
$mutex = new Mutex('very-critical-stuff', $lock);
if ($mutex->acquireLock(1000)) {
    // Do some very critical stuff

    // and release lock after you finish
    $mutex->releaseLock();
} else {
    throw new Exception('Unable to gain lock!');
}

互斥锁工厂

如果您想在项目中使用多个互斥锁，那么 MutexFabric 是正确的解决方案。您只需设置一次锁实现者，就可以使用尽可能多的互斥锁！

<?php
require 'vendor/autoload.php';

use NinjaMutex\Lock\MemcacheLock;
use NinjaMutex\MutexFabric;

$memcache = new Memcache();
$memcache->connect('127.0.0.1', 11211);
$lock = new MemcacheLock($memcache);
$mutexFabric = new MutexFabric('memcache', $lock);
if ($mutexFabric->get('very-critical-stuff')->acquireLock(1000)) {
    // Do some very critical stuff

    // and release lock after you finish
    $mutexFabric->get('very-critical-stuff')->releaseLock();
} else {
    throw new Exception('Unable to gain lock for very critical stuff!');
}

if ($mutexFabric->get('also-very-critical-stuff')->acquireLock(0)) {
    // Do some also very critical stuff

    // and release lock after you finish
    $mutexFabric->get('also-very-critical-stuff')->releaseLock();
} else {
    throw new Exception('Unable to gain lock for also very critical stuff!');
}

安装

Composer

下载 composer

wget -nc https://getcomposer.org.cn/composer.phar

并将依赖项添加到您的项目中

php composer.phar require arvenil/ninja-mutex:*

运行测试

测试需要 vfsStream 来运行。要在项目目录中安装它，只需运行

wget -nc https://getcomposer.org.cn/composer.phar && php composer.phar install --dev

在控制台中输入以下命令以运行测试

vendor/bin/phpunit

有些事情不起作用

请随意fork项目，修复错误，并最终请求pull请求。