README

This bundle allows a protection between several parallel php process accessing a single resource

quick start

// get manager
$semaphoreManager = $this->get("kitpages_semaphore.manager");

// wait for the semaphore disponibility
$semaphoreManager->aquire("my_semaphore_name");

// do someting interesting with the protected resource

// release the semaphore
$semaphoreManager->release("my_semaphore_name");

Features

• shared semaphore between several parallel php processes (using the filesystem)
• deadlock detection : consider a semaphore as dead after a configurable duration
• logging system for deadlock on a specific channel in monolog (channel : kitpages_semaphore)
• stopwatch to see semaphore usage in the timeline of the symfony debug toolbar

Installation

Using Composer, just $ composer require kitpages/semaphore-bundle package or:

{
  "require": {
    "kitpages/semaphore-bundle": "~1.4"
  }
}

Then add the bundle in AppKernel :

    public function registerBundles()
    {
        $bundles = array(
            // ...
            // use of monolog
            new Symfony\Bundle\MonologBundle\MonologBundle(),
            // the bundle itself
            new Kitpages\SemaphoreBundle\KitpagesSemaphoreBundle(),
        );
    }

The add configuration in your config.yml.

Default values are 0.1s for pooling sleep time and 5s for deadlock duration

kitpages_semaphore:
    sleep_time_microseconds: 100000
    dead_lock_microseconds: 5000000

Status

• stable, tested and under travis-ci

Versions

2014-02-11 : v1.4.0 : addded semaphore usage in the timeline of the SF2 debug toolbar

• no BC break
• new : added stopwatch to add semaphore usage in the timeline of the SF2 debug toolbar
• new : debug log less verbose
• new : warning log added on release on a not locked semaphore

2014-01-22 : v1.3.0 : refactoring based on file lock

• no BC break
• used file lock instead of SQL transaction

2014-01-14 : v1.2.0 : logger for dead lock

• no BC break
• new : use monolog on the channel "kitpages_semaphore" to send a warning for every deadlock
• fix : dependencies in composer.json
• enh : more unit testing for configuration parser and service initialisation in the DIC
• enh : Readme rewriting

2013-12-11 : v1.1.0 : atomicity in aquire-release process

• no BC Break
• new : add a db transaction around the aquire-release process to garanty atomicity

2013-12-05 : v1.0.0 : first release