Download the PHP package baraja-core/lock without Composer
On this page you can find all versions of the php package baraja-core/lock. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download baraja-core/lock
More information about baraja-core/lock
Files in baraja-core/lock
Package lock
Short Description Simple PHP function lock system.
License
Homepage https://github.com/baraja-core/lock
Informations about the package lock
Simple PHP lock
A simple library for processing and clearing locks in your PHP application. No dependencies are required for use, everything is done in native PHP.
Idea
Simple and efficient lock management in your PHP application.
To use it, just start a lock (you can use many different locks at the same time), wait for it to unlock, process any competing tasks, and then let the lock expire or unlock manually.
If you let the lock expire naturally, it will be automatically cleared via the Garbage collector component.
📦 Installation
It's best to use Composer for installation, and you can also find the package on Packagist and GitHub.
To install, simply use the command:
How to use
Simply request a static Lock
service over which you can perform the following operations:
By default, you should always stop a transaction at the end of an operation using the stopTransaction()
method. If you do not terminate the transaction, it will be terminated automatically when the protection limit expires.
The guard limit cannot be disabled and is used for cases where stopping a transaction fails for any reason, to avoid completely breaking the application. The application can always get itself out of a broken lock.
Named transactions and set your own limit
In the case of competing processes, we first need to wait for the previous transaction to complete.
To do this, it is ideal to use the wait()
method, which automatically waits for the previous transaction to complete.
After waiting for a free time slot, we create our own transaction in the current process, which we manually terminate later.
If the transaction is not manually stopped by the stopTransaction()
method, it will be automatically terminated after the protection interval expires.
If stopping the transaction fails directly at the system level for some reason (for example, you do not have the rights to delete the transaction file), the wait()
method will drop the request after 30 seconds at the latest (the interval can be set), even if the lock still exists.
This ensures that the application never gets completely stuck.
📄 License
baraja-core/lock
is licensed under the MIT license. See the LICENSE file for more details.