Download the PHP package noglitchyo/symfony-middleware-bundle without Composer

symfony-middleware-bundle

Introduces PSR-15 middleware support into Symfony framework.

Roadmap

• Full test coverage
• Documentation

This bundle is under heavy development and is not meant to be used in production. Feel free to contribute!

Description

Symfony Middleware Bundle provides support for PSR-15 middleware execution in Symfony application. It introduces a middleware dispatcher in a non-intrusive way, so it can be used with a minimal and simple configuration.

This bundle attempts to offer two implementations, so it can be used in different ways:

• through an event listener plugged on the events dispatched by the HttpKernel. It will execute the middleware collection before passing the request to the controller if no response were created by the middlewares.

• as a decorator of the HttpKernel with the MiddlewareStackKernel.

Getting started

Requirements

• Symfony 4
• PHP 7.3

Installation

Applications that use Symfony Flex

Open a command console, enter your project directory and execute:

Applications that don't use Symfony Flex

Step 1: Download the Bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.

Step 2: Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in the config/bundles.php file of your project:

Usage

Step 1: Create a middleware collection

First, it is required to define a middleware collection. The middleware collection will, as states its name, contains all the middleware to execute.

For this purpose, this bundle rely on the middleware collection implementation from noglitchyo/middleware-collection-request-handler which gives the ability to execute a collection of middlewares as if it was a single PSR-15 middleware or request handler with different execution strategies.

Example

services.yaml

Step 2: Define a middleware handler

Handler gives the instruction to execute the attached middleware collection. Once, it is defined, the collection of middlewares will be executed for every incoming requests.

It is possible to define some conditions on when the handler should be run:

• Route Path matching : if the route path of the request match the given route path
• Route Name matching : if the route name of the request match the given route name

Example

middlewares.yaml

Tests

Would like to the run the test suite? Go ahead:

composer test

References

https://www.php-fig.org/psr/psr-15/

License

This project is licensed under the MIT License - see the LICENSE.md file for details.