2017 © Pedro Peláez
 

library statemachine

Statemachine in PHP 5.3

image

metabor/statemachine

Statemachine in PHP 5.3

  • Tuesday, May 30, 2017
  • by Metabor
  • Repository
  • 17 Watchers
  • 90 Stars
  • 87,261 Installations
  • PHP
  • 2 Dependents
  • 1 Suggesters
  • 11 Forks
  • 2 Open issues
  • 14 Versions
  • 4 % Grown

The README.md

metabor/statemachine

Statemachine in PHP 5.6 / PHP 7, (*1)

Support

Gitter

Gitter chat, (*2)

Continuous Integration/Deployment

TravisCI

Build Status, (*3)

Open Issues

Open Issues, (*4)

Package Information

Packagist

Packagist Packagist Packagist Packagist, (*5)

Compatibility

MetaborStd Version, (*6)

Dependency Status

VersionEye

Dependency Status, (*7)

Test Coverage

Scrutinizer

Code Coverage, (*8)

Code Quality

Codeship

Codeship Status, (*9)

Codacy

Codacy, (*10)

Code Climate

Code Climate, (*11)

Scrutinizer

Scrutinizer Code Quality, (*12)

SensioLabsInsight

SensioLabsInsight, (*13)

Other

License Gittip, (*14)

Quickstart examples

Once installed, let's use a sample statemachine:, (*15)

<?php
require_once 'vendor/autoload.php';

use Metabor\Statemachine\Process;
use Metabor\Statemachine\State;
use Metabor\Statemachine\Statemachine;
use Metabor\Statemachine\Transition;

$closed = new State('closed');
$opened = new State('opened');

$eventOpen = 'open';
$eventClose = 'close';
$closed->addTransition(new Transition($opened, $eventOpen));
$closed->addTransition(new Transition($closed, $eventClose));
$opened->addTransition(new Transition($opened, $eventOpen));
$opened->addTransition(new Transition($closed, $eventClose));

// adding some action to events
// the parts of observing the event and executing the command are separated in this example
// normaly it could be put all together into your own command (base)class
$openCommand = new \Metabor\Callback\Callback(
        function ()
        {
            echo 'motor is opening door' . PHP_EOL;
        });
$observerForOpenEvent = new \Metabor\Observer\Callback($openCommand);
$closed->getEvent($eventOpen)->attach($observerForOpenEvent);

$closeCommand = new \Metabor\Callback\Callback(
        function ()
        {
            echo 'motor is closing door' . PHP_EOL;
        });
$observerForCloseEvent = new \Metabor\Observer\Callback($closeCommand);
$opened->getEvent($eventClose)->attach($observerForCloseEvent);

// stateful subject that belongs to this statemachine
$subject = new stdClass();

// start process with closed status;
$initialState = $closed;
$process = new Process('process name', $initialState);

$statemachine = new Statemachine($subject, $process);

echo 'Status:' . $statemachine->getCurrentState()->getName() . PHP_EOL;

echo 'Event:' . $eventOpen . PHP_EOL;
$statemachine->triggerEvent($eventOpen);
echo 'Status:' . $statemachine->getCurrentState()->getName() . PHP_EOL;

// opening an open door would not activate the motor
echo 'Event:' . $eventOpen . PHP_EOL;
$statemachine->triggerEvent($eventOpen);
echo 'Status:' . $statemachine->getCurrentState()->getName() . PHP_EOL;

echo 'Event:' . $eventClose . PHP_EOL;
$statemachine->triggerEvent($eventClose);
echo 'Status:' . $statemachine->getCurrentState()->getName() . PHP_EOL;

Features

This library implements a finite-state machine in PHP 5.3., (*16)

It was first developed for a talk at a conference. The example from my talk is available on Github and Packagist as metabor/statemachine-example., (*17)

In the namespace MetaborStd are abstract types defined that are exemplified implemented in this project. If you have to implement or use a statemachine in your project, feel free to either use this libary at all or replace the parts that didn't fit your needs by using the MetaborStd Interfaces., (*18)

Process Graph Drawing

The library supports visualizing of the process graph by using clue/graph and GraphViz "Graph Visualization Software"., (*19)

Install

The recommended way to install this library is through composer. New to composer?, (*20)

{
    "require": {
        "metabor/statemachine": "~1.2"
    }
}

Optional recommendation: In order to be able to use the process graph drawing feature you'll have to install GraphViz (dot executable). Users of Debian/Ubuntu-based distributions may simply invoke sudo apt-get install graphviz, Windows users have to download GraphViZ for Windows and remaining users should install from GraphViz homepage. To use this feature you also have to add this to your composer.json:, (*21)

{
    "require": {
        "graphp/graphviz": "*",
        "clue/graph": "*",
        "metabor/statemachine": "~1.2"
    }
}

An example how to draw and display the graph, can be found in metabor/statemachine-example., (*22)

Tests

This library uses phpunit for its extensive testsuite. You can either use a global installation or rely on the one composer installs when you first run $ composer install. This sets up the developer environment, so that you can now run it from the project root directory:, (*23)

$ php vendor/bin/phpunit

Contributing

If you encounter any issues, please don't hesitate to drop us a line, file a bug report or even best provide us with a patch / pull request and/or unit test to reproduce your problem., (*24)

Besides directly working with the code, any additional documentation, additions to our readme or even fixing simple typos are appreciated just as well., (*25)

Any feedback and/or contribution is welcome!, (*26)

License

Released under the terms of the permissive MIT license., (*27)

The Versions

30/05 2017

dev-master

9999999-dev

Statemachine in PHP 5.3

  Sources   Download

MIT

The Requires

 

The Development Requires

by Oliver Tischlinger

process statemachine status state machine

30/05 2017

v2.0.1

2.0.1.0

Statemachine in PHP 5.3

  Sources   Download

MIT

The Requires

 

The Development Requires

by Oliver Tischlinger

process statemachine status state machine

14/12 2016

v2.0.0

2.0.0.0

Statemachine in PHP 5.3

  Sources   Download

MIT

The Requires

 

The Development Requires

by Oliver Tischlinger

process statemachine status state machine

10/11 2016

v1.1.8

1.1.8.0

Statemachine in PHP 5.3

  Sources   Download

MIT

The Requires

 

The Development Requires

by Oliver Tischlinger

process statemachine status state machine

04/10 2016

v1.1.7

1.1.7.0

Statemachine in PHP 5.3

  Sources   Download

MIT

The Requires

 

The Development Requires

by Oliver Tischlinger

process statemachine status state machine

16/09 2016

v1.1.6

1.1.6.0

Statemachine in PHP 5.3

  Sources   Download

MIT

The Requires

 

The Development Requires

by Oliver Tischlinger

process statemachine status state machine

26/04 2016

v1.1.5

1.1.5.0

Statemachine in PHP 5.3

  Sources   Download

MIT

The Requires

 

The Development Requires

by Oliver Tischlinger

process statemachine status state machine

15/12 2015

v1.1.4

1.1.4.0

Statemachine in PHP 5.3

  Sources   Download

MIT

The Requires

 

The Development Requires

by Oliver Tischlinger

process statemachine status state machine

20/11 2015

v1.1.3

1.1.3.0

Statemachine in PHP 5.3

  Sources   Download

MIT

The Requires

 

The Development Requires

by Oliver Tischlinger

process statemachine status state machine

09/04 2015

v1.1.2

1.1.2.0

Statemachine in PHP 5.3

  Sources   Download

MIT

The Requires

 

The Development Requires

by Oliver Tischlinger

process statemachine status state machine

12/03 2015

v1.1.1

1.1.1.0

Statemachine in PHP 5.3

  Sources   Download

MIT

The Requires

 

The Development Requires

by Oliver Tischlinger

process statemachine status state machine

10/07 2014

v1.1.0

1.1.0.0

Statemachine in PHP 5.3

  Sources   Download

MIT

The Requires

 

The Development Requires

by Oliver Tischlinger

process statemachine status state machine

23/04 2014

v1.0.1

1.0.1.0

Statemachine in PHP 5.3

  Sources   Download

MIT

The Requires

 

by Oliver Tischlinger

process statemachine status state machine

19/02 2014

v1.0.0

1.0.0.0

Statemachine in PHP 5.3

  Sources   Download

MIT

The Requires

 

by Oliver Tischlinger

process statemachine status state machine