xabbuh/di-configuration-bundle

Override Symfony service definition configuration with ease

v0.1.0 2015-05-03 09:40 UTC

Requires

• php: >=5.3
• symfony/config: ~2.3
• symfony/dependency-injection: ~2.3
• symfony/http-kernel: ~2.3

Requires (Dev)

• matthiasnoback/symfony-dependency-injection-test: ~0.7
• symfony/framework-bundle: ~2.3

MIT

• Christian Flothmann

• dependency injection
• symfony
• configuration
• di
• service container
• customization
• customisation

README

This bundle makes it possible to easily customise existing service definitions defined in third-party bundles.

Note: Many bundles offer their own configuration options to customise how their services are configured. Please refer to their documentation first for available configuration options before using this bundle.

Installation

Use Composer to install the bundle:

$ composer require xabbuh/di-configuration-bundle

Then, enable it in your application:

// app/AppKernel.php
// ...

public function registerBundles()
{
    $bundles = array(
        // ...
        new Xabbuh\DiConfigurationBundle\XabbuhDiConfigurationBundle(),
    );

    // ...

    return $bundles;
}

Configuration

Note: You can only change the configuration of existing services. The bundle is not meant to be used to configure new services. If you want to add your own services use the built-in Symfony configuration mechanisms.

Customize Service Definitions

Change the class name of a service:

xabbuh_di_configuration:
    logger:
        class: app.logger

If you do not want to configure any other options of a particular service, you can omit the class key:

xabbuh_di_configuration:
    monolog.logger: app.logger

You can replace existing arguments using the arguments key. A reference to another service needs to be the service id prefixed with the @ character:

xabbuh_di_configuration:
    locale_listener:
        arguments:
            - de
            - @app.router

You can use the index key for an argument if you do not want to replace all arguments, but want to skip some of them. The following example only replaces the first and the third argument of the locale_listener service, but leaves the second argument as is:

xabbuh_di_configuration:
    locale_listener:
        arguments:
            - de
            - index: 2
              value: @app.request_stack