##Description
A simple Laravel wrapper for the Symfony lock component to provide semaphore locking.
When you have routines that take a longer time than usual to run, you may not want other processes attempting to run it. To prevent this you can acquire what is referred to as a lock or semaphore. This prevents problems of contention.
You can install the package via composer:
composer require hollyit/laravel-lock$lock = LaravelLock::make('test-lock')
if ($lock->acquire()) {
// Perform my long running task
$lock->release();
} else {
// Something is already running on this process so let's not do anything.
}Drivers can be configured in config/lock.php. View that file for additional details. To publish the configuration
php artisan vendor:publish --provider="Hollyit\LaravelLock\LaravelLockServiceProvider" --tag="config"File Drive:
(This is a wrapper of the Symfony FlockStore)
No additional setup required. By default this will use the system's temporary directory. You may override this in config or environment. Please see config/lock.php for details.
With the exception of Database, drivers are very simple wrappers. If you would like to add additional drivers, please consider a PR.
Database driver:
(This is a modification of the PdoStore, modified to use Laravel's database layer)
This will use your default database connection. Before using this driver you must publish and migrate your database.
php artisan vendor:publish --provider="Hollyit\LaravelLock\LaravelLockServiceProvider" --tag="migraions"If you wish to use a custom table name, then please modify your config/lock.php file prior to migrating.
Redis:
Redis isn't currently supported, but it will in a future release.
Custom drivers:
Other stores from the Symfony/lock package aren't currently supported. Migrating them over should be rather simple if you would like to (and please submit a PR).
You may also define custom drivers outside of what the original symfony/lock package offers. Under your config/lock.php configuration file, simple define a 'class' property to point to the class of the new driver. Drivers must implement the \Hollyit\LaravelLock\Contracts\LockDriver contract.
For additional details and features, please refer to the Symfony Lock documentation.
NOTE: Testing is extremely limited at this time given the need for this package on a client project. If you are willing to expand on test coverage, please do so and submit a PR.
composer testThis package was quickly developed due to the need of a current client project. If you would like to add more drivers, features or tests, then your help will be greatly welcomed.
Please see CONTRIBUTING for details.
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent