draw / dependency-injection
Dependency injection addons to Symfony
Installs: 3 837
Dependents: 16
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Requires
- php: >=8.2
- symfony/config: ^6.4.0
- symfony/dependency-injection: ^6.4.0
Requires (Dev)
- phpunit/phpunit: ^11.3
README
This package provides addons to the Symfony Dependency Injection component.
Installation
composer require draw/dependency-injection
Integration
The Draw\Component\DependencyInjection\Integration
namespace contains classes that can be used to easily integrate
subcomponents into a main bundle.
An example of this is all the draw components that are integrated into the DrawFrameworkExtraBundle
.
When creating the main bundle extension you can use the IntegrationTrait
to easily integrate all the subcomponents.
namespace Example\Bundle\MyBundle\DependencyInjection; use Draw\Component\DependencyInjection\IntegrationTrait; use Example\Component\MyComponent\DependencyInjection\MyCompnentIntegration; use Example\Component\MyOtherComponent\DependencyInjection\MyOtherComponentIntegration; class ExampleMyBundle extends Bundle { use ExtendableExtensionTrait; public function __construct() { $this->registerDefaultIntegrations(); } private function provideExtensionClasses(): array { return [ MyCompnentIntegration::class, ]; } public function getConfiguration(array $config, ContainerBuilder $container): ConfigurationInterface { return new Configuration($this->integrations); } public function load(array $configs, ContainerBuilder $container): void { $config = $this->loadIntegrations($configs, $container); // Do your bundle specific configuration here } public function prepend(ContainerBuilder $container): void { $this->prependIntegrations($container, 'example_my_bundle'); } }
registerDefaultIntegrations
The registerDefaultIntegrations
method will automatically register all the integrations that are in the provideExtensionClasses
method.
It will check if the class exists and if it does it will create a new instance of it and add it to the integrations
property.
That way you can define the integration classes in the specific component, and it will automatically be integrated into the main bundle if your component is installed.
loadIntegrations
The loadIntegrations
method will call the load
method on all the integrations that are registered.
It will automatically pass the configuration to the existing configuration only if they are enabled
.
prependIntegrations
The prependIntegrations
method will call the prepend
method on all the integrations that are registered.
It will check if the configuration is enabled
and if it is it will call the prepend
method.
Configuration
Here is an example of configuration base on the example above.
example_my_bundle: my_component: enabled: true my_component_configuration: true my_other_component: enabled: false
This example will enable the MyComponentIntegration
and disable the MyOtherComponentIntegration
.