matthiasnoback / lazy-services-bundle
Bundle for marking services and arguments as "lazy"
Installs: 33
Dependents: 0
Suggesters: 0
Security: 0
Stars: 17
Watchers: 4
Forks: 1
Open Issues: 0
Type:symfony-bundle
Requires
Requires (Dev)
- phpunit/phpunit: 3.7.*
This package is auto-updated.
Last update: 2024-10-29 04:36:17 UTC
README
By Matthias Noback
Installation
Run:
php composer.phar require matthiasnoback/lazy-services-bundle 0.2.*
Then register the bundle in /app/AppKernel.php
:
<?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:
<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):
<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.
When the referenced service does not exist, it will be skipped silently.
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:
# in config.yml:
matthias_lazy_services:
lazy_service_ids:
- mailer
- ...
When the referenced service does not exist, it will be skipped silently.