PHPackages                             roadrunner-php/symfony-lock-driver - 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 &amp; Helpers](/categories/utility)
4. /
5. roadrunner-php/symfony-lock-driver

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

roadrunner-php/symfony-lock-driver
==================================

RoadRunner: symfony/lock bridge

1.1.2(4w ago)121.8k↓60%21MITPHPPHP &gt;=8.1CI passing

Since Nov 10Pushed 4w ago5 watchersCompare

[ Source](https://github.com/roadrunner-php/symfony-lock-driver)[ Packagist](https://packagist.org/packages/roadrunner-php/symfony-lock-driver)[ Docs](https://roadrunner.dev)[ GitHub Sponsors](https://github.com/sponsors/roadrunner-server)[ RSS](/packages/roadrunner-php-symfony-lock-driver/feed)WikiDiscussions 1.x Synced 1w ago

READMEChangelog (5)Dependencies (10)Versions (6)Used By (1)

[   ![](https://github.com/roadrunner-server/.github/assets/8040338/040fb694-1dd3-4865-9d29-8e0748c2c8b8) ](https://roadrunner.dev)RoadRunner Lock Integration for Symfony
=======================================

[](#roadrunner-lock-integration-for-symfony)

[![PHP Version Require](https://camo.githubusercontent.com/cc14ba9a47319b7f91b4db4fba6d522197d755338987a73259718c1297c485e1/68747470733a2f2f706f7365722e707567782e6f72672f726f616472756e6e65722d7068702f73796d666f6e792d6c6f636b2d6472697665722f726571756972652f706870)](https://packagist.org/packages/roadrunner-php/symfony-lock-driver)[![Latest Stable Version](https://camo.githubusercontent.com/becb4656e33b0bcdab2590120bc7ba5b89e686093bd4bb87355edc86036001e1/68747470733a2f2f706f7365722e707567782e6f72672f726f616472756e6e65722d7068702f73796d666f6e792d6c6f636b2d6472697665722f762f737461626c65)](https://packagist.org/packages/roadrunner-php/symfony-lock-driver)[![phpunit](https://github.com/roadrunner-php/symfony-lock-driver/actions/workflows/phpunit.yml/badge.svg)](https://github.com/roadrunner-php/symfony-lock-driver/actions)[![psalm](https://github.com/roadrunner-php/symfony-lock-driver/actions/workflows/psalm.yml/badge.svg)](https://github.com/roadrunner-php/symfony-lock-driver/actions)[![Codecov](https://camo.githubusercontent.com/4c959d3219de87eff3bf0340c0b91a7b94ef3d054876f554ee27cb30f1b19023/68747470733a2f2f636f6465636f762e696f2f67682f726f616472756e6e65722d7068702f73796d666f6e792d6c6f636b2d6472697665722f6272616e63682f312e782f67726170682f62616467652e737667)](https://codecov.io/gh/roadrunner-php/symfony-lock-driver/)[![Total Downloads](https://camo.githubusercontent.com/109ddbab2b7dfc1140faae0a6c1f8b0f9974e932afd1bb92563a4d47ca053e6d/68747470733a2f2f706f7365722e707567782e6f72672f726f616472756e6e65722d7068702f73796d666f6e792d6c6f636b2d6472697665722f646f776e6c6f616473)](https://packagist.org/roadrunner-php/symfony-lock-driver/phpunit)[![](https://camo.githubusercontent.com/4442b73a11753b80fdd7b442ddbfaf8383902c8b9ffa66ed1718e8c62e102f2e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646973636f72642d636861742d6d6167656e74612e737667)](https://discord.gg/8bZsjYhVVk)

This package is a bridge that connects the powerful RoadRunner Lock plugin with the Symfony Lock component. It's designed to help you easily manage distributed locks in your PHP applications, particularly when you're working with high-traffic web applications and microservices.

Requirements
------------

[](#requirements)

Make sure that your server is configured with following PHP version and extensions:

- PHP 8.1+

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require roadrunner-php/symfony-lock-driver
```

Usage
-----

[](#usage)

Using the RoadRunner Lock with Symfony is straightforward. Here's a simple example:

```
use RoadRunner\Lock\Lock;
use Spiral\Goridge\RPC\RPC;
use Spiral\RoadRunner\Symfony\Lock\RoadRunnerStore;
use Symfony\Component\Lock\LockFactory;

require __DIR__ . '/vendor/autoload.php';

$lock = new Lock(RPC::create('tcp://127.0.0.1:6001'));
$factory = new LockFactory(
    new RoadRunnerStore($lock)
);
```

### Store options

[](#store-options)

`RoadRunnerStore` accepts two timing options:

OptionDefaultDescription`$initialTtl``300.0`Default lock time-to-live, in seconds. When it elapses the lock is released automatically; `0` means it never expires on its own.`$initialWaitTtl``0`Default time to wait for the lock to become free, in seconds. `0` is effectively **non-blocking**: the RoadRunner server caps a `0` wait at `1ms`, so acquiring an already-held lock fails almost immediately. A positive value blocks for up to that duration.```
// Wait up to 5 seconds for the lock, and hold it for at most 30 seconds.
$store = (new RoadRunnerStore($lock))->withTtl(ttl: 30.0, waitTtl: 5.0);
```

Read more about using Symfony Lock component [here](https://symfony.com/doc/current/components/lock.html).

Contributing
------------

[](#contributing)

Contributions are welcome! If you find an issue or have a feature request, please open an [issue](https://github.com/roadrunner-php/issues) or submit a pull request.

Credits
-------

[](#credits)

- [gam6itko](https://github.com/gam6itko)
- [butschster](https://github.com/butschster)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance94

Actively maintained with recent releases

Popularity30

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 58.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 ~196 days

Recently: every ~236 days

Total

6

Last Release

29d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/773481?v=4)[Pavel Buchnev](/maintainers/butschster)[@butschster](https://github.com/butschster)

---

Top Contributors

[![gam6itko](https://avatars.githubusercontent.com/u/3841197?v=4)](https://github.com/gam6itko "gam6itko (21 commits)")[![butschster](https://avatars.githubusercontent.com/u/773481?v=4)](https://github.com/butschster "butschster (7 commits)")[![msmakouz](https://avatars.githubusercontent.com/u/67324318?v=4)](https://github.com/msmakouz "msmakouz (4 commits)")[![roxblnfk](https://avatars.githubusercontent.com/u/4152481?v=4)](https://github.com/roxblnfk "roxblnfk (2 commits)")[![rustatian](https://avatars.githubusercontent.com/u/8040338?v=4)](https://github.com/rustatian "rustatian (2 commits)")

---

Tags

atomic-locklockphproadrunnerspiralsymfonyroadrunnerlockspiralroadrunner-php

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/roadrunner-php-symfony-lock-driver/health.svg)

```
[![Health](https://phpackages.com/badges/roadrunner-php-symfony-lock-driver/health.svg)](https://phpackages.com/packages/roadrunner-php-symfony-lock-driver)
```

###  Alternatives

[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.8M674](/packages/shopware-core)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

762297.9k53](/packages/civicrm-civicrm-core)[azuracast/azuracast

The AzuraCast self-hosted web radio station management suite.

4.0k27.9k](/packages/azuracast-azuracast)[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

5.2k5.6k](/packages/shlinkio-shlink)[oxid-esales/oxideshop-metapackage-ce

This is OXID eShop compilation metapackage.

12506.8k21](/packages/oxid-esales-oxideshop-metapackage-ce)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
