net_bazzline/component_lock

php component lock

1.0.3 2014-04-24 13:57 UTC

README

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

General

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.

Implementations

Two implementations exists. The FileLock and the RuntimeLock.

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.

FileLock

The FileLock 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.

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

History

  • 1.0.3
    • Added LockDependentInterface
  • 1.0.2
    • Added constructor with optional parameter $name for FileLock and RuntimeLock
  • 1.0.1
    • Switched to LGPLv3
  • 1.0.0
    • Finished LockInterface and LockAwareInterface
    • Added implementation for FileLock and RuntimeLock
    • Covered implementations with unittest