A simple locking library ... that is based on file locking (and that's awesome).
Imagine you have two tasks that you do not want to overlap (they modify the same data for example). Using this library will bring you peace of mind.
The library uses file locking mechanism to ensure it works correctly. This means that it can be used only on applications/instances/processes that share a common file system. A website on one server does just that.
composer require ivopetkov/lockUsing the following two methods (acquire() and release()) will ensure no two applications/instances/processes execute the code between them.
<?php
require 'vendor/autoload.php';
use IvoPetkov\Lock;
Lock::acquire('lock1'); // Acquires a lock and pauses other applications/instances/processes until the lock is released.
// Do something awesome
Lock::release('lock1'); // Releases the acquired lock.Full documentation is available as part of this repository.
The default timeout to acquire a lock is 1.5 seconds. You can modify it by calling the following method:
Lock::setDefaultLockTimeout(2.5);The temporary lock files needed by the library are stored in your OS temp dir. You can modify it by calling the following method:
Lock::setLocksDir('/some/other/temp/dir/');If multiple applications use this library, you can call the following methods to prefix the keys provided. This way the different applications can use the same keys without interference.
Lock::setKeyPrefix('app1');This project is licensed under the MIT License. See the license file for more information.
Feel free to open new issues and contribute to the project. Let's make it awesome and let's do in a positive way.
This library is created and maintained by Ivo Petkov (ivopetkov.com).