PHPackages                             proklung/symfony-middleware-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. proklung/symfony-middleware-bundle

ActiveSymfony-bundle[Framework](/categories/framework)

proklung/symfony-middleware-bundle
==================================

MiddlewareBundle for Symfony

1.0.11(5y ago)117MITPHPPHP >=7.3

Since Apr 30Pushed 4y ago1 watchersCompare

[ Source](https://github.com/ProklUng/symfony.middleware.bundle)[ Packagist](https://packagist.org/packages/proklung/symfony-middleware-bundle)[ RSS](/packages/proklung-symfony-middleware-bundle/feed)WikiDiscussions master Synced today

READMEChangelog (4)Dependencies (7)Versions (5)Used By (0)

Бандл поддержки Middleware для Symfony
======================================

[](#бандл-поддержки-middleware-для-symfony)

Форк [пакета](https://github.com/zholus/symfony-middleware-bundle). Доработано под личные нужды, добавлены некоторые стандартные middleware.

Инсталляция
-----------

[](#инсталляция)

`composer require proklung/symfony-middleware-bundle`

Кастомные middlewares
---------------------

[](#кастомные-middlewares)

1. **OnlyAjaxMiddleware** - проверка на Ajax вызов.
2. **CsrfMiddleware** - проверка Csrf токена.

Оригинальная документация
-------------------------

[](#оригинальная-документация)

This bundle allow you to create simple middleware that executes right before controller does on each requests.

Its almost looks like middleware in laravel framework.

There are 4 possible ways to inject your middleware to your request.

Register middleware
-------------------

[](#register-middleware)

### Global middleware

[](#global-middleware)

Global middleware executes on every http requests before every controller.

To register middleware as global you need implement interface `\Zholus\SymfonyMiddleware\GlobalMiddlewareInterface`.

That's all.

### Controller middleware

[](#controller-middleware)

This middleware will execute on every action in certain controller, to attach middleware to controller, you need setup some configuration in your services.yaml file:

```
App\Controller\WelcomeController:
    tags:
        - { name: 'middleware.controller', middleware: 'App\Middleware\AuthNeededMiddleware' }

```

That's all, just attach tag with options: `name` - `middleware.controller` and `middleware` - fully-qualified class name.

You can attach more that one middleware to controller

```
App\Controller\WelcomeController:
    tags:
        - { name: 'middleware.controller', middleware: 'App\Middleware\AuthNeededMiddleware' }
        - { name: 'middleware.controller', middleware: 'App\Middleware\AdminAccessMiddleware' }

```

### Action middleware

[](#action-middleware)

This middleware is similar to controller, we need to add just one more option called `action`

```
App\Controller\WelcomeController:
    tags:
        - { name: 'middleware.controller', middleware: 'App\Middleware\AuthNeededMiddleware', action: 'index' }

```

That means that when action `index` will run, than our middleware will executed

### Route middleware

[](#route-middleware)

In your routes configuration file add array option called `middleware`:

```
index:
    path: /
    controller: App\Controller\WelcomeController::index
    options:
        middleware: ['App\Middleware\AuthNeededMiddleware', 'App\Middleware\AdminAccessMiddleware']

```

Those middlewares will attach to route name in our example to `index`.

Priority of middleware executions
---------------------------------

[](#priority-of-middleware-executions)

Order of execution of different types of middleware is next: `global` middleware execute first, next `controller`, next `action` and last `route`.

For global middlewares you can specify in services.yaml, lets see an example

```
App\Middleware\AuthNeededMiddleware:
    tags:
        - { name: 'middleware.global', priority: 2 }

App\Middleware\AdminAccessMiddleware:
    tags:
        - { name: 'middleware.global', priority: 1 }

```

Default priority without specifying in configuration is 0. The higher the number, the earlier a middleware is executed.

For other 3 types (controller, action, route) priority will the same is in the configuration, for example in route configuration:

```
index:
    path: /
    controller: App\Controller\WelcomeController::index
    options:
        middleware: ['App\Middleware\AuthNeededMiddleware', 'App\Middleware\AdminAccessMiddleware']

```

First will execute `App\Middleware\AuthNeededMiddleware` and next `App\Middleware\AdminAccessMiddleware`. And same in other 2 types.

Middleware example
------------------

[](#middleware-example)

In example below, our middleware check if given credentials is represent user with admin access, if not, we will return response with access denied message.

As we can see, if any of middlewares returning Response, it means that next middlewares will not be executed.

Returning of null means that next middleware will be executed.

```