matthiasnoback/lazy-services-bundle

Bundle for marking services and arguments as "lazy"

LazyServicesBundle

By Matthias Noback, _(*1)

, _(*2)

Installation

Run:, _(*3)

php composer.phar require matthiasnoback/lazy-services-bundle 0.2.*

Then register the bundle in /app/AppKernel.php:, _(*4)

<?php

class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...
            new Matthias\LazyServicesBundle\MatthiasLazyServicesBundle,
        );
    }
}

Usage

Lazy arguments

This bundle allows you to mark services as lazy by adding tags to arguments that refer to them:, _(*5)

<service id="some_service" class="...">
    <argument type="service" id="mailer" key="mailer" />
    <tag name="lazy_argument" key="mailer" />
</service>

The argument key can be a string (like in the example above), or a number, indicating the index of the argument (starting with 0):, _(*6)

<service id="some_service" class="...">
    <argument type="service" id="event_dispatcher" /><!-- key is 0 -->
    <argument type="service" id="mailer" /><!-- key is 1 -->
    <tag name="lazy_argument" key="1" />
</service>

Both examples will effectively convert the mailer service to a lazy-loading service., _(*7)

When the referenced service does not exist, it will be skipped silently., _(*8)

Lazy services by configuration

For your convenience, this bundle also allows you to mark services as lazy by adding its service id to a list of lazy services in your application configuration:, _(*9)

# in config.yml:

matthias_lazy_services:
    lazy_service_ids:
        - mailer
        - ...

When the referenced service does not exist, it will be skipped silently., _(*10)