PHPackages texthtml/php-lock - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)
1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. texthtml/php-lock
Abandoned → [symfony/lock](/?search=symfony%2Flock)ArchivedLibrary[Utility & Helpers](/categories/utility)
texthtml/php-lock
=================
ressource lock
v2.2.1(8y ago)30231.9k↓25.6%4[2 PRs](https://github.com/texthtml/php-lock/pulls)2aGPLv3PHPCI passing
Since Sep 13Pushed 5mo ago3 watchersCompare
[ Source](https://github.com/texthtml/php-lock)[ Packagist](https://packagist.org/packages/texthtml/php-lock)[ RSS](/packages/texthtml-php-lock/feed)WikiDiscussions main Synced 1mo ago
READMEChangelog (3)Dependencies (3)Versions (14)Used By (2)
php-lock
========
[](#php-lock)
[](https://travis-ci.org/texthtml/php-lock)[](https://packagist.org/packages/texthtml/php-lock)[](http://www.gnu.org/licenses/agpl-3.0.html)[](https://packagist.org/packages/texthtml/php-lock)[](https://scrutinizer-ci.com/g/texthtml/php-lock/?branch=master)
[php-lock](https://packagist.org/packages/texthtml/php-lock) is a library that makes locking on resources easy. It can be used to avoid access to a file during write operations or to prevent crontabs to overlap. And it's designed to integrate well with Dependancy Injection (eg Symfony Container or Pimple).
Installation
------------
[](#installation)
With Composer :
```
composer require texthtml/php-lock
```
Usage
-----
[](#usage)
You can create an object that represent a lock on a file. You can then try to acquire that lock by calling `$lock->acquire()`. If the lock fail it will throw a `\TH\Lock\Exception` (useful for CLI tools built with [Symfony Console Components documentation](http://symfony.com/doc/current/components/console/introduction.html)). If the lock is acquired the program can continue.
### Locking a file exclusively
[](#locking-a-file-exclusively)
```
use TH\Lock\FileLock;
$lock = new FileLock('/path/to/file');
$lock->acquire();
// other processes that try to acquire a lock on the file will fail
// edit /path/to/file
$lock->release();
// other processes can now acquire a lock on the file
```
### Sharing a lock on a file
[](#sharing-a-lock-on-a-file)
```
use TH\Lock\FileLock;
$lock = new FileLock('/path/to/file', FileLock::SHARED);
$lock->acquire();
// other processes that try to acquire an exclusive lock on the file will fail,
// processes that try to acquire an shared lock on the file will succeed
// read /path/to/file
$lock->release();
// other processes can now acquire an exclusive lock on the file if no other shared lock remains.
```
### Auto release
[](#auto-release)
`$lock->release()` is called automatically when the lock is destroyed so you don't need to manually release it at the end of a script or if it got out of scope.
```
use TH\Lock\FileLock;
function batch() {
$lock = new FileLock('/some/file');
$lock->acquire();
// lot of editing on file
}
batch();
// the lock will be released here even if $lock->release() is not called in batch()
```
### Using lock for crontabs
[](#using-lock-for-crontabs)
When you don't want some crontabs to overlap you can make a lock on the same file in each crontab. The `TH\Lock\LockFactory` can ease the process and provide more helpful message in case of overlap.
```
$lock = $factory->create('protected resource', 'process 1');
$lock->acquire();
// process 1 does stuff
```
```
$lock = $factory->create('protected resource', 'process 2');
$lock->acquire();
// process 2 does stuff
```
When process 1 is running and we start process 2, an Exception will be thrown: "Could not acquire exclusive lock on protected resource" and if the factory was configured with a `\Psr\Log\LoggerInterface`, messages explaining what happend would be logged:
```
process 1: exclusive lock acquired on protected resource
process 2: could not acquire exclusive lock on protected resource
process 2: lock released on protected resource
```
The only `LockFactory` available at the moment is the `TH\Lock\FileFactory`. This factory autmatically create lock files for your resources in the specified folder.
```
use TH\Lock\FileFactory;
$factory = new FileFactory('/path/to/lock_dir/');
$lock = $factory->create('resource identifier');
```
### Aggregating locks
[](#aggregating-locks)
If you want to simplify acquiring multiple locks at once, you can use the `\TH\Lock\LockSet`:
```
use TH\Lock\LockSet;
$superLock = new LockSet([$lock1, $lock2, $lock3]);
// You can make a set with any types of locks (eg: FileLock, RedisSimpleLock or another nested LockSet)
$superLock->acquire();
// all locks will be released when $superLock is destroyed or when `$superLock->release()` is called
```
It will try to acquire all locks, if it fails it will release the lock that have been acquired to avoid locking other processes.
note: `Lock` put inside a `LockSet` should not be used manually anymore
Notes
-----
[](#notes)
### Distributed system
[](#distributed-system)
On a distributed system, file based locking does not work, You can use the [php-lock redis extension](https://github.com/texthtml/php-lock-redis) to have a safe lock instead.
### Health Score
49
—
FairBetter than 95% of packages
Maintenance48
Moderate activity, may be stable
Popularity43
Moderate usage in the ecosystem
Community19
Small or concentrated contributor base
Maturity70
Established project with proven stability
Bus Factor1
Top contributor holds 83.3% of commits — single point of failure
How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.
**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.
**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.
**Maturity (30%)** — Project age, version count, PHP version support, and release stability.
### Release Activity
Cadence
Every ~147 days
Recently: every ~232 days
Total
8
Last Release
3235d ago
Major Versions
v1.1.2 → v2.0.02015-10-18
### Community
Maintainers
[mathroc](/maintainers/mathroc)
---
Top Contributors
[](https://github.com/mathroc "mathroc (45 commits)")[![text-html-renovate[bot]](https://avatars.githubusercontent.com/u/6465918?v=4)](https://github.com/text-html-renovate[bot] "text-html-renovate[bot] (6 commits)")[](https://github.com/denpamusic "denpamusic (2 commits)")[](https://github.com/ayrtonvwf "ayrtonvwf (1 commits)")
---
Tags
cronlockphp
### Embed Badge
```
[](https://phpackages.com/packages/texthtml-php-lock)
```
### Alternatives
[ecotone/ecotone
Supporting you in building DDD, CQRS, Event Sourcing applications with ease.
558549.8k17](/packages/ecotone-ecotone)[civicrm/civicrm-core
Open source constituent relationship management for non-profits, NGOs and advocacy organizations.
728272.9k20](/packages/civicrm-civicrm-core)[j0k3r/php-readability
Automatic article extraction from HTML
186808.8k6](/packages/j0k3r-php-readability)[symfony/ai-platform
PHP library for interacting with AI platform provider.
51927.7k136](/packages/symfony-ai-platform)[symfony/ai-agent
PHP library for building agentic applications.
30536.7k44](/packages/symfony-ai-agent)[spomky-labs/pwa-bundle
Progressive Web App Manifest Generator Bundle for Symfony.
6144.4k1](/packages/spomky-labs-pwa-bundle)
PHPackages © 2026
[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)