Хроники Yii3

⚡️ #yiisoftMutex #yiisoftMutexFile #yiisoftMutexPdoMysql #yiisoftMutexPdoPgsql #yiisoftMutexPdoOracle

Полностью переосмыслен и переписан код пакета Yii Mutex (PR, PR, PR), обеспечивающий взаимное исключение исполнения критических участков кода в «состоянии гонки».

—————

Основные интерфейсы и классы

Пакет предоставляет интерфейсы и классы, которые уже используются в конкретных реализациях.

• MutexInterface — интерфейс мьютекс-объекта с методами acquire() (включает блокировку) и release() (отключает блокировку).

• MutexFactoryInterface — интерфейс фабрики, создающей экземпляр мьютекс-объекта с двумя методами:

- create() — создание мьютекс-объекта;

- createAndAcquire() — создание мьютекс-объекта и включение блокировки. При неудачном включении блокировки будет брошено исключение.

• MutexFactory — абстрактный класс фабрики, реализующй интерфейс MutexFactoryInterface, с уже реализованным методом createAndAcquire().

• RetryAcquireTrait — трейт, позволяющий выполнить несколько попыток блокировки в течение заданного времени.

В общем случае есть два варианта использования:

$mutexFactory = new MyMutexFactory();

$mutex = $mutexFactory->create('critical_logic');

if (!$mutex->acquire(1000)) {
  throw new \RuntimeException('Unable to acquire "critical_logic" mutex.');
}

// business logic execution

$mutex->release();

$mutexFactory = new MyMutexFactory();

// При неудачной блокировке будет
// брошено исключение
$mutex = $mutexFactory->createAndAcquire('critical_logic', 1000);

// business logic execution

$mutex->release();

—————

Класс SimpleMutex

Предоставляет альтернативный вариант работы с мьютексами. Пример:

$mutex = new SimpleMutex(new MyMutexFactory());

if (!$mutex->acquire('critical_logic', 1000)) {
  throw new \RuntimeException('Unable to acquire "critical_logic" mutex.');
}

// business logic execution

$mutex->release();

—————

Класс Synchronizer

Позволяет запускать callback-функции в синхронизированном режиме (в один момент времени выполняется только один экземпляр callback-функции). Пример:

$synchronizer = new Synchronizer(new MyMutexFactory());

$newCount = $synchronizer->execute('critical_logic', function () {
    return $counter->increase();
}, 10);

—————

Соответствующие изменение внесены в мьютекс-драйверы:

- File Driver (PR),
- MySQL PDO Driver (PR),
- Postgres PDO Driver (PR),
- Oracle PDO Driver (PR).

417 viewsСергей Предводителев, edited 05:00

Хроники Yii3

⚡️ #yiisoftMutexFile #yiisoftMutexPdoMysql #yiisoftMutexPdoPgsql #yiisoftMutexPdoOracle

В мьютекс-драйверах удалена опция autoRelease (теперь она всегда включена), а автоматическое снятие блокировки выполняется с помощью деструктора класса (__desctruct()) вместо регистрации функции, которая будет выполнена при завершении скрипта (register_shutdown_function()):

- File Driver (PR),
- MySQL PDO Driver (PR),
- Postgres PDO Driver (PR),
- Oracle PDO Driver (PR).

Спасибо kafkiansky за идею 👍

364 viewsСергей Предводителев, 09:00

Хроники Yii3

⚡️ #yiisoftMutexPdoPgsql #yiisoftMutexPdoOracle

Навели порядок в пакетах Yii Mutex Oracle PDO Driver (PR) и Yii Mutex Postgres PDO Driver (PR):

- класс мьютекса наследуется от Mutex из основного пакета;
- подчищен код, улучшены doc-блоки;
- обновлены dev-зависимости;
- уровень psalm повышен до 1;
- добавлены тесты;
- в файле .editorconfig добавлена секция *.yml;
- исключены все служебные файлы при создании архива репозитория;
- актуализирован readme;
- улучшены конфигурация GitHub Workflow и другие служебные файлы.

323 viewsСергей Предводителев, 14:00

Хроники Yii3

⚡️ #yiisoftMutexFile #yiisoftMutexPdoMysql #yiisoftMutexPdoPgsql #yiisoftMutexPdoOracle

В мьютекс-драйверах в readme добавлена документация по использованию:

- File Driver (PR),
- MySQL PDO Driver (PR),
- Postgres PDO Driver (PR),
- Oracle PDO Driver (PR).

375 viewsСергей Предводителев, 10:30

Хроники Yii3

🎁 #yiisoftMutex #yiisoftMutexFile #yiisoftMutexPdoMysql #yiisoftMutexPdoPgsql #yiisoftMutexPdoOracle #yiisoftMutexRedis #Релиз #ПервыйРелиз

Первый релиз Yii Mutex 1.0.0 (новость на yiiframework.com).

Этот пакет, используя механизм блокировки, обеспечивает взаимное исключение исполнения критических участков кода в «состоянии гонки». Доступны несколько вариантов использования.

1) Запуск callback-функции в синхронизированном режиме (в один момент времени выполняется только один экземпляр callback-функции) с помощью класса Synchronizer:

/** @var \Yiisoft\Mutex\Synchronizer $synchronizer */
$newCount = $synchronizer->execute('critical_logic', function () {
    return $counter->increase();
}, 10);

2) Установка и снятие блокировки вручную с помощью класса SimpleMutex:

/** @var \Yiisoft\Mutex\SimpleMutex $simpleMutex */
if (!$simpleMutex->acquire('critical_logic', 1000)) {
  throw new \RuntimeException('Unable to acquire "critical_logic" mutex.');
}
$newCount = $counter->increase();
$simpleMutex->release();

3) Ручное создание мьютекса и управление им:

/** @var \Yiisoft\Mutex\MutexFactoryInterface $mutexFactory */
$mutex = $mutexFactory->createAndAcquire('critical', 10);
$newCount = $counter->increase();
$mutex->release();

или вариант с полным контролем:

/** @var \Yiisoft\Mutex\MutexFactoryInterface $mutexFactory */
$mutex = $mutexFactory->create('critical');
if (!$mutex->acquire(10)) {
    throw new \RuntimeException('Unable to acquire mutex "critical".');
}
$newCount = $counter->increase();
$mutex->release();

Вместе с основным пакетом зарелизены мьютекс-драйвера:

- File Driver 1.0.0
- MySQL PDO Driver 1.0.0
- Postgres PDO Driver 1.0.0
- Oracle PDO Driver 1.0.0
- Redis Driver 1.0.0

366 viewsСергей Предводителев, 06:30

Хроники Yii3