php component lock

Installs: 796

Dependents: 3

Suggesters: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

2.1.0 2015-09-10 14:00 UTC


The build status of the current master branch is tracked by Travis CI: Build Status


This component provides the LockInterface as well as an LockAwareInterface. It comes with two implementations of the LockInterface.

You can use this interface to lock classes or processes to prevent changes in an object (so you freeze/lock the class for property setting) or lock an existing process (like a cronjob) to prevent double execution.

This component was created by splitting up the PHP_Bazzline_Utility repository.


Two implementations exists. The FileNameLock and the RuntimeLock.


The RuntimeLock can be used to lock an instance from modification. If you implement an check in each setter method, you can easily create a instance (by a factory for example) and lock it afterwards to prevent modifications.


The FileNameLock can be used to lock an class from instantiated multiple times. This is useful if you implement this in cronjobs or business processes that should run alone.


The FileHandlerLock can be used to lock file with php`s flock functionality.

Future Improvements

  • implement "wait" like implemented here.
  • take a look to the semaphore project to see if thing can be merged
  • take a look if all projects can work together
  • take a look to havvg/lock


  • 2.1.0 - released 2015-09-10
    • implemented support for SplFileObject in FileHandlerLock
  • 2.0.1 - released 2015-09-09
    • stabalized dependencies
  • 2.0.0 - released 2015-09-08
    • added FileHandlerLock
    • renamed FileLock to FileNameLock
    • renamed "getName" to "getResource" and "setName" to "setResource" in "LockInterface"
  • 1.0.3
    • added LockDependentInterface
  • 1.0.2
    • added constructor with optional parameter $name for FileNameLock and RuntimeLock
  • 1.0.1
    • switched to LGPLv3
  • 1.0.0
    • added implementation for FileLock and RuntimeLock
    • covered implementations with unittest
    • finished LockInterface and LockAwareInterface