Uh oh!
There was an error while loading.Please reload this page.
- Notifications
You must be signed in to change notification settings - Fork5.3k
Description
Relates tosymfony/symfony#27320
This middleware is used to enable/disable a middleware based on an arbitrary condition. Main use-case is for maintaining a unique list of middleware across environments, but disabling/enabling some in test env for instance (but there are many others). It accepts either a simple boolean or a callable returning a boolean.
Usage when using the component standalone should be straightforward enough, but not as obvious when using within the framework.
When used with the framework, it leverages Symfony DI capabilities (usingservice decoration). It can uses a simple parameter value, the result of an expression, or even a callable injected in its constructor (by extending the decorator or by using DI):
TestOnlyMiddleware:~test.TestOnlyMiddleware:class:Symfony\Component\Messenger\Middleware\Enhancers\ActivationMiddlewareDecoratordecorates:TestOnlyMiddlewarearguments: -"@test.TestOnlyMiddleware.inner" -"@=parameter('kernel.environment') === 'test'"
using an invokable service:
TestOnlyMiddleware:~ActivationStrategyService: ~# invokable servicetest.TestOnlyMiddleware:class:Symfony\Component\Messenger\Middleware\Enhancers\ActivationMiddlewareDecoratordecorates:TestOnlyMiddlewarearguments: -"@test.TestOnlyMiddleware.inner" -"@StrategyService"
using a method of a service as a closure (dynamically executed, as previously):
TestOnlyMiddleware:~ActivationStrategyService:~test.TestOnlyMiddleware:class:Symfony\Component\Messenger\Middleware\Enhancers\ActivationMiddlewareDecoratordecorates:TestOnlyMiddlewarearguments: -"@test.TestOnlyMiddleware.inner" -["@StrategyService", 'isEnabled']
Note: a more concise syntax can be used leveraging anonymous services:
TestOnlyMiddleware:class:Symfony\Component\Messenger\Middleware\Enhancers\ActivationMiddlewareDecoratorarguments: -!service{ class: TestOnlyMiddleware } -"@=parameter('kernel.environment') === 'test'"
[...]