class ServiceContainer in Service Container 7.2

Static Service Container wrapper extension - initializes the container.

Hierarchy

• class \Drupal
  • class \ServiceContainer

4 string references to 'ServiceContainer'

ContainerTest::underscoreCamelizeDataProvider in tests/src/DependencyInjection/ContainerTest.php

Data Provider for ::underscore and ::camelize.

ServiceContainerIntegrationTest::getInfo in lib/Drupal/service_container/Tests/ServiceContainerIntegrationTest.php

service_container_modules_enabled in ./service_container.module

Implements hook_modules_enabled().

service_container_stream_wrappers_alter in ./service_container.module

Implements hook_stream_wrappers_alter().

File

lib/ServiceContainer.php, line 13

Contains ServiceContainer

class ServiceContainer extends Drupal {

  /**
   * Initializes the container.
   *
   * This can be safely called from hook_boot() because the container will
   * only be build if we have reached the DRUPAL_BOOTSTRAP_FULL phase.
   *
   * @return bool
   *   TRUE when the container was initialized, FALSE otherwise.
   */
  public static function init() {

    // If this is set already, just return.
    if (isset(static::$container)) {
      return TRUE;
    }
    $container_builder = static::getContainerBuilder();
    if ($container_builder
      ->isCached()) {
      static::$container = $container_builder
        ->compile();
      static::dispatchStaticEvent('containerReady', array(
        static::$container,
      ));
      return TRUE;
    }

    // If we have not yet fully bootstrapped, we can't build the container.
    if (drupal_bootstrap(NULL, FALSE) != DRUPAL_BOOTSTRAP_FULL) {
      return FALSE;
    }

    // Rebuild the container.
    static::$container = $container_builder
      ->compile();
    static::dispatchStaticEvent('containerReady', array(
      static::$container,
    ));
    return (bool) static::$container;
  }

  /**
   * Dispatches an event to static classes.
   *
   * This is needed to inform other static classes when the container is ready.
   *
   * @param string $event
   *   The member function to call.
   * @param array $arguments
   *   The arguments to pass.
   */
  protected static function dispatchStaticEvent($event, $arguments) {
    $event_listeners = static::$container
      ->getParameter('service_container.static_event_listeners');
    foreach ($event_listeners as $class) {
      $function = $class . '::' . $event;
      if (is_callable($function)) {
        call_user_func_array($function, $arguments);
      }
    }
  }

  /**
   * Reset the internal cache.
   *
   * Note: This is just thought for tests.
   */
  public static function reset() {
    static::getContainerBuilder()
      ->reset();
    static::$container = NULL;
  }

  /**
   * @return \Drupal\service_container\DependencyInjection\CachedContainerBuilder
   */
  protected static function getContainerBuilder() {
    $service_provider_manager = new ServiceProviderPluginManager();

    // This is an internal API, but we need the cache object.
    $cache = _cache_get_object('cache');
    $container_builder = new CachedContainerBuilder($service_provider_manager, $cache);
    return $container_builder;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
Drupal::$container	protected static	property	The currently active container object.
Drupal::getContainer Deprecated	public static	function	Returns the currently active global container.
Drupal::hasService	public static	function	Indicates if a service is defined in the container.
Drupal::service	public static	function	Retrieves a service from the container.
ServiceContainer::dispatchStaticEvent	protected static	function	Dispatches an event to static classes.
ServiceContainer::getContainerBuilder	protected static	function
ServiceContainer::init	public static	function	Initializes the container.
ServiceContainer::reset	public static	function	Reset the internal cache.