laasti/stack

From request to response. A middleware stack with 3 phases: prepare, respond and close

Laasti/Stack

A middleware stack with 3 phases:, _(*1)

1. Prepare is where you adapt the request;
2. Respond is where you modify the response generated by the prepare phase;
3. Close is where you output the response and close the current request (ie. closing a session, sending an e-mail...);

Laasti\Stack has 1 dependency: symfony/http-foundation. I chose it because it handles requests and responses in a straightforward fashion. I am waiting for PSR7 to mature and will eventually remove the dependency on HttpFoundation in favour of the PSR7 standard., _(*2)

It also provides an integration with League\Container., _(*3)

Installation

composer require laasti/stack

Usage

Without League\Container:, _(*4)

$stack = new Laasti\Stack\Stack;

//You must at least have one PrepareableMiddleware that returns a Response
$stack->push(new MyPrepareableMiddleware);

//Ouputs the response automatically
$stack->execute(Request::createFromGlobals());

With League\Container:, _(*5)

$container = new League\Container\Container;
$resolver = new Laasti\Stack\ContainerResolver($container);
$stack = new Laasti\Stack\Stack($resolver);
$container->add('MyPrepareableMiddleware');

//You must at least have one PrepareableMiddleware that returns a Response
$stack->push('MyPrepareableMiddleware');

//Ouputs the response automatically
$stack->execute(Request::createFromGlobals());

If you encounter problems with priority, make sure that your middlewares define just one of the middleware types. Also make sure your middlewares do as little as possible so that you can fine tune the priority more easily., _(*6)

Contributing

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request :D

History

See CHANGELOG.md for more information., _(*7)

Credits

Author: Sonia Marquette (@nebulousGirl), _(*8)

License

Released under the MIT License. See LICENSE file., _(*9)