2017 © Pedro Peláez
 

library workflow

Create extendible and maintainable applications by harnessing the power of pipelines.

image

cerbero/workflow

Create extendible and maintainable applications by harnessing the power of pipelines.

  • Friday, August 18, 2017
  • by cerbero
  • Repository
  • 11 Watchers
  • 102 Stars
  • 726 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 19 Forks
  • 2 Open issues
  • 17 Versions
  • 54 % Grown

The README.md

, (*1)

Workflow

Build Status Latest Stable Version License Code Climate Scrutinizer Gratipay, (*2)

SensioLabsInsight, (*3)

Let's assume we want to develop a registration process, the main thing is storing user data, but we also want to validate input, hash the password and send a welcome email., (*4)

Now imagine this process as concentric circles: the storing of user data is the inner circle, whereas validation, hashing, email sending and any other logic are the increasingly outer circles., (*5)

Such concentric circles, or pipes, can be called all at once in a pipeline and have several advantages including running specific code before or after a given command and adding/removing any logic without even touching controllers., (*6)

This allows you to have all your controllers with just a few lines (usually 2) per action, while keeping all their functionalities., (*7)

This package is intended to automate the creation of such pipelines by using simple Artisan commands and it's endowed with other facilities like auto-validation, management of pipelines in a single file and visualization of their graphical representation in console., (*8)

Note: if you are using Laravel 4, have a look at this version that leverages the decorators design pattern., (*9)

Installation

Run this command in your application root:, (*10)

composer require cerbero/workflow

and add this string to the providers array in config/app.php:, (*11)

'Cerbero\Workflow\WorkflowServiceProvider',

Configuration

By default all the generated workflows are placed in app/Workflows. You can change it by running:, (*12)

php artisan vendor:publish

and then edit the file config/workflow.php., (*13)

Create a workflow

Taking the introductive example, let's create the registration workflow by running:, (*14)

php artisan workflow:create RegisterUser --attach="hash notify"

The following files are automatically created under the app directory:, (*15)

File (click to see the code) Description
Commands/RegisterUserCommand.php incapsulates the current task
Http/Requests/RegisterUserRequest.php contains the validation rules and permissions
Workflows/RegisterUser/Hash.php the attached pipe to hash the password
Workflows/RegisterUser/Notify.php the attached pipe to send the welcome email
Workflows/workflows.yml contains all the created pipelines with their own pipes

Update, (*16)

As of v3.1 you can also map route parameters into commands constructor, (*17)

While both commands and requests are well documented, let's have a look at one of the newly created pipes, let's say Hash.php., (*18)

This class has two methods: before() is run before handling the RegisterUserCommand, which is passed as argument, whereas after() is run after handling the command and also has the value returned by the handled command as parameter e.g. the User model., (*19)

You can inject whatever you need in both methods, everything is resolved by the service container automatically. Furthermore if you don't need either before() or after(), you can safely delete the unused method., (*20)

All workflows are stored within the workflows.yml file that makes it easier to read and update pipelines and their pipes even if, as you will see, there are also Artisan commands to automate these tasks., (*21)

As you may have noticed, you only created Hash and Notify but nothing to validate data. Every workflow validates the input automatically by reading the validation rules and permissions from the generated requests e.g. RegisterUserRequest., (*22)

However sometimes you may not have input to validate, in these cases you can avoid the creation of the Request class by using the --unguard flag:, (*23)

php artisan workflow:create TakeItEasy --unguard

Here is a recap of the workflow:create options:, (*24)

Option Shortcut Description
--attach -a The pipes to attach to the workflow
--unguard -u Do not make this workflow validate data

Read a workflow

To better understand the workflow of a given pipeline, you can run the command:, (*25)

php artisan workflow:read RegisterUser

that will output something similar:, (*26)

             ║
╔════════════╬════════════╗
║       Hash ║ before()   ║
║ ╔══════════╬══════════╗ ║
║ ║   Notify ║ before() ║ ║
║ ║ ╔════════╩════════╗ ║ ║
║ ║ ║  RegisterUser   ║ ║ ║
║ ║ ╚════════╦════════╝ ║ ║
║ ║   Notify ║ after()  ║ ║
║ ╚══════════╬══════════╝ ║
║       Hash ║ after()    ║
╚════════════╬════════════╝
             ∇

The arrow in the middle of the drawing shows the itinerary of the code within the pipeline. Please note how the Hash pipe wraps the Notify pipe that in turn wraps the RegisterUser command and how the methods of the pipes are run before and after the command respectively., (*27)

Usage

Now that you have created the registration workflow and seen how it works in theory, it's time to see it in action., (*28)

There are many ways to run the workflow. To let all controllers have a $workflow property after being resolved, edit the app/Http/Controllers/Controller.php class like so:, (*29)

use Cerbero\Workflow\RunsWorkflow;
use Cerbero\Workflow\WorkflowRunner;

abstract class Controller extends BaseController implements WorkflowRunner {

    use RunsWorkflow;

}

and now you can run your workflow by calling it through the $workflow property available in every controller:, (*30)

public function store()
{
    $this->workflow->registerUser();
}

Otherwise if you prefer to run workflow only in some controllers (or even non-controllers), you can type-hint the Cerbero\Workflow\Workflow class:, (*31)

use Cerbero\Workflow\Workflow;

class RegisterController extends Controller {

    public function __construct(Workflow $workflow)
    {
        $this->workflow = $workflow;
    }

    public function store()
    {
        $this->workflow->registerUser();
    }

}

Finally, you can use the Workflow facade that has been automatically registered during the installation, just for you:, (*32)

public function store()
{
    \Workflow::registerUser();
}

You can see a working demo here., (*33)

Update a workflow

One of the biggest advantages of using pipelines is that you can easily add and remove functionalities keeping the rest of your code intact., (*34)

The Artisan command workflow:update can attach and detach pipes of existing pipelines:, (*35)

php artisan workflow:update RegisterUser --attach="upload log" --detach="notify"

By default the detached pipes are not deleted, if you want to, you can use the --force flag:, (*36)

php artisan workflow:update RegisterUser --detach="notify" --force

Sometimes you may want to sort the attached pipes to carry in or out a given pipe, you can do that by editing the workflows.yml file. It contains all the created pipelines and their own pipes ordered from the outer (the first to be run) to the inner., (*37)

Here is a recap of the workflow:update options:, (*38)

Option Shortcut Description
--attach -a The pipes to attach to the workflow
--detach -d The pipes to detach from the workflow
--force -f Delete the files of detached pipes

Delete a workflow

To delete an entire pipeline, you can run:, (*39)

php artisan workflow:delete RegisterUser

Like the update command, the detached pipes are not deleted by default, again you can use the --force flag:, (*40)

php artisan workflow:delete RegisterUser --force

The Versions

18/08 2017

dev-develop

dev-develop https://github.com/cerbero90/Workflow

Create extendible and maintainable applications by harnessing the power of pipelines.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Andrea Marco Sartori

laravel dispatcher bus pipeline hub

27/07 2016

dev-analysis-zRPaan

dev-analysis-zRPaan https://github.com/cerbero90/Workflow

Create extendible and maintainable applications by harnessing the power of pipelines.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Andrea Marco Sartori

laravel dispatcher bus pipeline hub

27/07 2016

dev-master

9999999-dev https://github.com/cerbero90/Workflow

Create extendible and maintainable applications by harnessing the power of pipelines.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Andrea Marco Sartori

laravel dispatcher bus pipeline hub

29/02 2016

4.1.1

4.1.1.0 https://github.com/cerbero90/Workflow

Create extendible and maintainable applications by harnessing the power of pipelines.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Andrea Marco Sartori

laravel dispatcher bus pipeline hub

23/12 2015

4.1.0

4.1.0.0 https://github.com/cerbero90/Workflow

Create extendible and maintainable applications by harnessing the power of pipelines.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Andrea Marco Sartori

laravel dispatcher bus pipeline hub

16/07 2015

4.0.1

4.0.1.0 https://github.com/cerbero90/Workflow

Create extendible and maintainable applications by harnessing the power of pipelines.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Andrea Marco Sartori

laravel dispatcher bus pipeline hub

15/07 2015

4.0.0

4.0.0.0 https://github.com/cerbero90/Workflow

Create extendible and maintainable applications by harnessing the power of pipelines.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Andrea Marco Sartori

laravel dispatcher bus pipeline hub

06/05 2015

3.1.0

3.1.0.0 https://github.com/cerbero90/Workflow

Create extensible and maintainable applications by harnessing the power of pipelines.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Andrea Marco Sartori

laravel dispatcher bus pipeline hub

21/02 2015

3.0.1

3.0.1.0 https://github.com/cerbero90/Workflow

Create extensible and maintainable applications by harnessing the power of pipelines.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Andrea Marco Sartori

laravel dispatcher bus pipeline hub

20/02 2015

3.0.0

3.0.0.0 https://github.com/cerbero90/Workflow

Create extensible and maintainable applications by harnessing the power of pipelines.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Andrea Marco Sartori

laravel dispatcher bus pipeline hub

13/09 2014

2.1.0

2.1.0.0

Laravel console command to help you create extensible and maintainable projects by leveraging the decorators design pattern.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Andrea Marco Sartori

laravel artisan workflow decorators

09/09 2014

2.0.1

2.0.1.0

Speed up the workflow to add new features to your Laravel projects.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Andrea Marco Sartori

laravel artisan workflow decorators

08/09 2014

2.0.0

2.0.0.0

Speed up the workflow to add new features to your Laravel projects.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Andrea Marco Sartori

laravel artisan workflow decorators

28/07 2014

1.1.1

1.1.1.0

Speed up the workflow to add new features to your Laravel projects.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Andrea Marco Sartori

laravel artisan workflow decorators

26/07 2014

1.1.0

1.1.0.0

Speed up the workflow to add new features to your Laravel projects.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Andrea Marco Sartori

laravel artisan workflow decorators

24/07 2014

1.0.1

1.0.1.0

Speed up the workflow to add new features to your Laravel projects.

  Sources   Download

MIT

The Requires

 

The Development Requires

by Andrea Marco Sartori

laravel artisan workflow decorators

24/07 2014

1.0.0

1.0.0.0

Speed up the workflow to add new features to your Laravel projects.

  Sources   Download

The Requires

 

The Development Requires

by Andrea Marco Sartori