class ContainerBuilder

Same name in other branches
  1. 9 core/lib/Drupal/Core/DependencyInjection/ContainerBuilder.php \Drupal\Core\DependencyInjection\ContainerBuilder
  2. 10 core/lib/Drupal/Core/DependencyInjection/ContainerBuilder.php \Drupal\Core\DependencyInjection\ContainerBuilder
  3. 11.x core/lib/Drupal/Core/DependencyInjection/ContainerBuilder.php \Drupal\Core\DependencyInjection\ContainerBuilder

Drupal's dependency injection container builder.

@todo Submit upstream patches to Symfony to not require these overrides.

Hierarchy

  • class \Drupal\Core\DependencyInjection\ContainerBuilder extends \Symfony\Component\DependencyInjection\ContainerBuilder

Expanded class hierarchy of ContainerBuilder

Related topics

168 files declare their use of ContainerBuilder
AcceptHeaderRoutingTestServiceProvider.php in core/modules/system/tests/modules/accept_header_routing_test/src/AcceptHeaderRoutingTestServiceProvider.php
AccessResultTest.php in core/tests/Drupal/Tests/Core/Access/AccessResultTest.php
Contains \Drupal\Tests\Core\Access\AccessResultTest.
AuthenticationProviderPassTest.php in core/tests/Drupal/Tests/Core/DependencyInjection/Compiler/AuthenticationProviderPassTest.php
BaseFieldDefinitionTest.php in core/tests/Drupal/Tests/Core/Entity/BaseFieldDefinitionTest.php
BaseFieldDefinitionTestBase.php in core/tests/Drupal/Tests/Core/Field/BaseFieldDefinitionTestBase.php

... See full list

File

core/lib/Drupal/Core/DependencyInjection/ContainerBuilder.php, line 19

Namespace

Drupal\Core\DependencyInjection
View source
class ContainerBuilder extends SymfonyContainerBuilder {
    
    /**
     * @var \Doctrine\Instantiator\InstantiatorInterface|null
     */
    private $proxyInstantiator;
    
    /**
     * {@inheritdoc}
     */
    public function __construct(ParameterBagInterface $parameterBag = NULL) {
        parent::__construct($parameterBag);
        $this->setResourceTracking(FALSE);
    }
    
    /**
     * Retrieves the currently set proxy instantiator or instantiates one.
     *
     * @return InstantiatorInterface
     */
    private function getProxyInstantiator() {
        if (!$this->proxyInstantiator) {
            $this->proxyInstantiator = new RealServiceInstantiator();
        }
        return $this->proxyInstantiator;
    }
    
    /**
     * A 1to1 copy of parent::shareService.
     *
     * @todo https://www.drupal.org/project/drupal/issues/2937010 Since Symfony
     *   3.4 this is not a 1to1 copy.
     */
    protected function shareService(Definition $definition, $service, $id, array &$inlineServices) {
        if ($definition->isShared()) {
            $this->services[$lowerId = strtolower($id)] = $service;
        }
    }
    
    /**
     * Overrides Symfony\Component\DependencyInjection\ContainerBuilder::set().
     *
     * Drupal's container builder can be used at runtime after compilation, so we
     * override Symfony's ContainerBuilder's restriction on setting services in a
     * frozen builder.
     *
     * @todo Restrict this to synthetic services only. Ideally, the upstream
     *   ContainerBuilder class should be fixed to allow setting synthetic
     *   services in a frozen builder.
     */
    public function set($id, $service) {
        if (strtolower($id) !== $id) {
            throw new \InvalidArgumentException("Service ID names must be lowercase: {$id}");
        }
        SymfonyContainer::set($id, $service);
        // Ensure that the _serviceId property is set on synthetic services as well.
        if (isset($this->services[$id]) && is_object($this->services[$id]) && !isset($this->services[$id]->_serviceId)) {
            $this->services[$id]->_serviceId = $id;
        }
    }
    
    /**
     * {@inheritdoc}
     */
    public function register($id, $class = null) {
        if (strtolower($id) !== $id) {
            throw new \InvalidArgumentException("Service ID names must be lowercase: {$id}");
        }
        return parent::register($id, $class);
    }
    
    /**
     * {@inheritdoc}
     */
    public function setAlias($alias, $id) {
        $alias = parent::setAlias($alias, $id);
        // As of Symfony 3.4 all aliases are private by default.
        $alias->setPublic(TRUE);
        return $alias;
    }
    
    /**
     * {@inheritdoc}
     */
    public function setDefinition($id, Definition $definition) {
        $definition = parent::setDefinition($id, $definition);
        // As of Symfony 3.4 all definitions are private by default.
        // \Symfony\Component\DependencyInjection\Compiler\ResolvePrivatesPassOnly
        // removes services marked as private from the container even if they are
        // also marked as public. Drupal requires services that are public to
        // remain in the container and not be removed.
        if ($definition->isPublic()) {
            $definition->setPrivate(FALSE);
        }
        return $definition;
    }
    
    /**
     * {@inheritdoc}
     */
    public function setParameter($name, $value) {
        if (strtolower($name) !== $name) {
            throw new \InvalidArgumentException("Parameter names must be lowercase: {$name}");
        }
        parent::setParameter($name, $value);
    }
    
    /**
     * A 1to1 copy of parent::callMethod.
     *
     * @todo https://www.drupal.org/project/drupal/issues/2937010 Since Symfony
     *   3.4 this is not a 1to1 copy.
     */
    protected function callMethod($service, $call, array &$inlineServices = array()) {
        $services = self::getServiceConditionals($call[1]);
        foreach ($services as $s) {
            if (!$this->has($s)) {
                return;
            }
        }
        call_user_func_array(array(
            $service,
            $call[0],
        ), $this->resolveServices($this->getParameterBag()
            ->resolveValue($call[1])));
    }
    
    /**
     * {@inheritdoc}
     */
    public function __sleep() {
        assert(FALSE, 'The container was serialized.');
        return array_keys(get_object_vars($this));
    }

}

Members

Title Sort descending Modifiers Object type Summary
ContainerBuilder::$proxyInstantiator private property
ContainerBuilder::callMethod protected function A 1to1 copy of parent::callMethod.
ContainerBuilder::getProxyInstantiator private function Retrieves the currently set proxy instantiator or instantiates one.
ContainerBuilder::register public function
ContainerBuilder::set public function Overrides Symfony\Component\DependencyInjection\ContainerBuilder::set().
ContainerBuilder::setAlias public function
ContainerBuilder::setDefinition public function
ContainerBuilder::setParameter public function
ContainerBuilder::shareService protected function A 1to1 copy of parent::shareService.
ContainerBuilder::__construct public function
ContainerBuilder::__sleep public function

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.