softius/phlow

A framework agnostic PHP library to build and execute workflows

Phlow - Worfklow Model and Engine

![Software License][ico-license] ![Code Climate][ico-maintenance] ![Code Climate][ico-coverage], _(*1)

Phlow is a workflow modeller and engine for PHP. Heavily inspired by BPMN 2.0 and Apache Camel, Phlow attempts to provide a library to design and implement business processes in PHP projects. It utilises the notion of workflow to model a process of any kind, through which a piece of work passes from initiation to completion., _(*2)

Phlow process models can be created using PHP. No third party tools are required to model and/or execute your process., _(*3)

Phlow is a framework agnostic solution., _(*4)

Features

:white_check_mark: Sequence flow\ :white_check_mark: Conditional flow\ :white_check_mark: Error handling\ :white_check_mark: Callbacks\ :white_check_mark: Boolean expressions for Conditions\ :white_check_mark: PSR/3 Logger integration\ :white_check_mark: Execution path replay\ :white_check_mark: Workflow model in plain/text format\ :white_check_mark: Execution path in plain/text format, _(*5)

See the Roadmap for more information about the upcoming releases., _(*6)

Getting Started

The following image illustrates a simple process for dealing with a non-functioning lamp. Once a non-functioning lamp is found, the flow evaluates whether the lamp is plugged in. If not, it evaluates whether the lamp has been burned out. In any case, particular actions must be taken i.e. replace the lamp., _(*7)

, _(*8)

Also, the following code illustrates the model for the same process., _(*9)

``` php $builder = new WorkflowBuilder(); $builder ->start() ->choice() ->when('isPluggedIn') ->callback() // Plug in lamp ->when('isBurnedOut') ->callback() // Replace lamp ->otherwise() ->callback() // Repair lamp ->endAll(), <sub>(*10)</sub>

Once the model bas been built, it can be executed by creating a new instance. At this point it is possible to pass some data that could be made available throughout the process. The data can be any object which could be also updated as part of the process.

``` php
$workflow = $builder->getWorkflow();
$instance = new WorkflowInstance($workflow, $data);
$instance->execute();

Installation

Phlow can be installed to your PHP project by executing the following composer command. Please note that currently there is no stable version yet available., <sub>(*11)</sub>

``` bash $ composer require softius/phlow 0.4.0, <sub>(*12)</sub>

## Documentation
* [Overview][link-overview]
* [Workflow Model][link-workflow-model]
* [Workflow Engine][link-workflow-engine]
* [Workflow Builder][link-workflow-builder]
* [Sequence Flow - Example][link-sequence-flow]
* [Conditional Flow - Example][link-conditional-flow]
* [FAQs][link-faqs]

## Testing

``` bash
$ composer test

Security

If you discover any security related issues, please email softius@gmail.com instead of using the issue tracker., <sub>(*13)</sub>

Credits

• Iacovos Constantinou
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*14)</sub>