janschumann/dic

Integrates Symfony´s dependency injection container with drupal.

Drupal dependency injection container integration

, _(*1)

Overview

Integrates the Symfony´s Dependency Injection Container with drupal., _(*2)

Installation

This project can be checked out with composer., _(*3)

{
  "require": {
    "janschumann/dic": "*"
  }
}

Confguration

Usually no configuration is necessary., _(*4)

The default dic cache dir will be determined by DRUPAL_ROOT . '/' . variable_get('file_public_path', '') . '/dic'., _(*5)

This can be customized by setting the dic_root_dir variable., _(*6)

Via shell script:, _(*7)

$ drush vset dic_root_dir <path/to/cache/dir>

Via php:, _(*8)

variable_set('dic_root_dir', '<path/to/cache/dir>');

Usage

Class autoloading is done via composer using the composer_classloader module., _(*9)

By default a settings.xml or an environment specific derivate (settings_<environment>.xml) is loaded., _(*10)

Provided services

This module provides the symfony event dispacher as a service available through the container., _(*11)

An instance of the event dispacher can be retrieved by, _(*12)

$dispatcher = drupal_dic()->get('event_dispatcher');

To add a listener to an event, add te following to your settings.xml file., _(*13)

<service id="my_service" class="%my_service.class%">
  <tag name="drupal.event_listener" event="<my_event_name>" method="<method_on_my_service>" />
</service>

An event is dispached by:, _(*14)

drupal_dic()->get('event_dispatcher')->dispatch('<my_event_name>', <the event class>);

Register bundles

Your modules may implement hook_dic_bundle_info() as described in dic.api.php to register their bundles., _(*15)

Example:, _(*16)

/**
 * Implements @see hook_dic_bundle_info()
 */
function <my_module>_dic_bundle_info() {
  return array('bundles' => array("\\MyNamespace\\MyBundle\\Bundle\\MyBundle\\MyBundle"));
}