anourvalar/laravel-atom

ACID API

2.21.18 2025-10-12 07:09 UTC

Requires

• php: ^8.0
• laravel/framework: ^8.0|^9.0|^10.0|^11.0|^12.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.26
• orchestra/testbench: ^9.0|^10.0
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^11.0
• psalm/plugin-laravel: ^3.0
• squizlabs/php_codesniffer: ^3.7

MIT

• laravel
• condition
• lock
• transaction
• race-condition
• atomic
• atomicity
• race
• anourvalar
• lockForUpdate

README

Installation

composer require anourvalar/laravel-atom

Usage

Action after transaction commit

Atom::onCommit(function () {
    dispatch(new Job());
});

Action after transaction rollBack

Atom::onRollBack(function () {
    Storage::delete('file.jpg');
});

Pessimistic lock

Atom::lock('user');

Atom::lockUser($user->id); // equals to: Atom::lock('user', $user->id);

Optimistic lock

try {
    Atom::strategy('optimistic_transaction')->lock('week_report');
} catch (\AnourValar\LaravelAtom\Exceptions\OptimisticTransactionException $e) {
    // already in progress..
}