Download the PHP package zlikavac32/symfony-extras without Composer
On this page you can find all versions of the php package zlikavac32/symfony-extras. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download zlikavac32/symfony-extras
More information about zlikavac32/symfony-extras
Files in zlikavac32/symfony-extras
Package symfony-extras
Short Description Various extra functionality for Symfony
License MIT
Informations about the package symfony-extras
Symfony extras
This repository adds a few extra functionality that I miss in the Symfony components. Functionality is currently only DIC and console related.
Table of contents
- Introduction
- Installation
- Usage
- Runnable
- Dynamic service decorators and service linker
- Dynamic event dispatchers
- Dynamic composite services
- Examples
Introduction
Idea of this library is to use what you need. No dependency is explicitly required as no code is run by default. It provides few things, like various compiler passes to make a life a bit easier.
Compiler passes are all idempotent.
Installation
Recommended installation is through Composer.
Usage
Different concepts exist in this library.
Runnable
symfony/console is a great package, but one can get into trouble when trying to decorate commands. This library defines \Zlikavac32\SymfonyExtras\Command\Runnable\Runnable
interface which is then injected into \Zlikavac32\SymfonyExtras\Command\Runnable\RunnableCommand
.
DIC compiler pass that automates this is provided in \Zlikavac32\SymfonyExtras\DependencyInjection\Compiler\ConsoleRunnablePass
.
Read more about this concept in docs/runnable.md.
Dynamic service decorators and service linker
Symfony provides out of the box service decoration, but it can get messy when there is to much decoration involved. This library offers two compiler passes to tackle that. First is \Zlikavac32\SymfonyExtras\DependencyInjection\Compiler\DecoratorPass
and the second is \Zlikavac32\SymfonyExtras\DependencyInjection\Compiler\ServiceLinkerPass
.
Idea is to define template services that are decorators, and then tag services that need decoration. Since certain decorators need other services or arguments, service linker is used to link services through tags.
Read more about this concept in docs/linker.md.
Dynamic event dispatchers
Symfony provides \Symfony\Component\EventDispatcher\DependencyInjection\RegisterListenersPass
to register event dispatchers. Compiler pass that can automate that process is provided in \Zlikavac32\SymfonyExtras\DependencyInjection\Compiler\EventDispatcherPass
.
Read more about this concept in docs/dynamic-event-dispatcher.md.
Dynamic composite services
Certain services have composite nature in a sense that they require other services either in their constructor, or through method injection. Symfony provides solution in some degree through tagged service injection. This library provides compiler pass in \Zlikavac32\SymfonyExtras\DependencyInjection\Compiler\DynamicCompositePass
that provides a bit more functionality.
Read more about this concept in docs/dynamic-composite.md.
One might say that here is to much magic
involved, but if you understand how it all works, there is hardly any magic left.
buildMapOfTagsAndServiceIds()
Method findTaggedServiceIds()
on the \Symfony\Component\DependencyInjection\ContainerBuilder
finds tags in linear time depending on the number of services, so for M
queries and N
services, we have N * M
operations.
Function buildMapOfTagsAndServiceIds()
provided in this repo builds a map of tag names to the sets of service ids that are tagged with them. If we assume access to the hash map is in constant time, now we have N + M
operations.
Do note that by not calling findTaggedServiceIds()
, method \Symfony\Component\DependencyInjection\ContainerBuilder::findUnusedTags()
will return more tags than it should. If you relay on that method, then this library is not for you.
Examples
Check examples folder for examples.