Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. ServicesConfigurator.php

class ServicesConfigurator

@author Nicolas Grekas <p@tchwork.com>

Hierarchy

  • class \Symfony\Component\DependencyInjection\Loader\Configurator\AbstractConfigurator
    • class \Symfony\Component\DependencyInjection\Loader\Configurator\ServicesConfigurator extends \Symfony\Component\DependencyInjection\Loader\Configurator\AbstractConfigurator

Expanded class hierarchy of ServicesConfigurator

File

vendor/symfony/dependency-injection/Loader/Configurator/ServicesConfigurator.php, line 25

Namespace

Symfony\Component\DependencyInjection\Loader\Configurator
View source
class ServicesConfigurator extends AbstractConfigurator {
    public const FACTORY = 'services';
    private Definition $defaults;
    private array $instanceof;
    private string $anonymousHash;
    private int $anonymousCount;
    public function __construct(ContainerBuilder $container, PhpFileLoader $loader, array &$instanceof, ?string $path = null, int &$anonymousCount = 0) {
        $this->defaults = new Definition();
        $this->instanceof =& $instanceof;
        $this->anonymousHash = ContainerBuilder::hash($path ?: mt_rand());
        $this->anonymousCount =& $anonymousCount;
        $instanceof = [];
    }
    
    /**
     * Defines a set of defaults for following service definitions.
     */
    public final function defaults() : DefaultsConfigurator {
        return new DefaultsConfigurator($this, $this->defaults = new Definition(), $this->path);
    }
    
    /**
     * Defines an instanceof-conditional to be applied to following service definitions.
     */
    public final function instanceof(string $fqcn) : InstanceofConfigurator {
        $this->instanceof[$fqcn] = $definition = new ChildDefinition('');
        return new InstanceofConfigurator($this, $definition, $fqcn, $this->path);
    }
    
    /**
     * Registers a service.
     *
     * @param string|null $id    The service id, or null to create an anonymous service
     * @param string|null $class The class of the service, or null when $id is also the class name
     */
    public final function set(?string $id, ?string $class = null) : ServiceConfigurator {
        $defaults = $this->defaults;
        $definition = new Definition();
        if (null === $id) {
            if (!$class) {
                throw new \LogicException('Anonymous services must have a class name.');
            }
            $id = \sprintf('.%d_%s', ++$this->anonymousCount, preg_replace('/^.*\\\\/', '', $class) . '~' . $this->anonymousHash);
        }
        elseif (!$defaults->isPublic() || !$defaults->isPrivate()) {
            $definition->setPublic($defaults->isPublic() && !$defaults->isPrivate());
        }
        $definition->setAutowired($defaults->isAutowired());
        $definition->setAutoconfigured($defaults->isAutoconfigured());
        // deep clone, to avoid multiple process of the same instance in the passes
        $definition->setBindings(unserialize(serialize($defaults->getBindings())));
        $definition->setChanges([]);
        $configurator = new ServiceConfigurator($this->container, $this->instanceof, true, $this, $definition, $id, $defaults->getTags(), $this->path);
        return null !== $class ? $configurator->class($class) : $configurator;
    }
    
    /**
     * Removes an already defined service definition or alias.
     *
     * @return $this
     */
    public final function remove(string $id) : static {
        $this->container
            ->removeDefinition($id);
        $this->container
            ->removeAlias($id);
        return $this;
    }
    
    /**
     * Creates an alias.
     */
    public final function alias(string $id, string $referencedId) : AliasConfigurator {
        $ref = static::processValue($referencedId, true);
        $alias = new Alias((string) $ref);
        if (!$this->defaults
            ->isPublic() || !$this->defaults
            ->isPrivate()) {
            $alias->setPublic($this->defaults
                ->isPublic());
        }
        $this->container
            ->setAlias($id, $alias);
        return new AliasConfigurator($this, $alias);
    }
    
    /**
     * Registers a PSR-4 namespace using a glob pattern.
     */
    public final function load(string $namespace, string $resource) : PrototypeConfigurator {
        return new PrototypeConfigurator($this, $this->loader, $this->defaults, $namespace, $resource, true, $this->path);
    }
    
    /**
     * Gets an already defined service definition.
     *
     * @throws ServiceNotFoundException if the service definition does not exist
     */
    public final function get(string $id) : ServiceConfigurator {
        $definition = $this->container
            ->getDefinition($id);
        return new ServiceConfigurator($this->container, $definition->getInstanceofConditionals(), true, $this, $definition, $id, []);
    }
    
    /**
     * Registers a stack of decorator services.
     *
     * @param InlineServiceConfigurator[]|ReferenceConfigurator[] $services
     */
    public final function stack(string $id, array $services) : AliasConfigurator {
        foreach ($services as $i => $service) {
            if ($service instanceof InlineServiceConfigurator) {
                $definition = $service->definition
                    ->setInstanceofConditionals($this->instanceof);
                $changes = $definition->getChanges();
                $definition->setAutowired((isset($changes['autowired']) ? $definition : $this->defaults)
                    ->isAutowired());
                $definition->setAutoconfigured((isset($changes['autoconfigured']) ? $definition : $this->defaults)
                    ->isAutoconfigured());
                $definition->setBindings(array_merge($this->defaults
                    ->getBindings(), $definition->getBindings()));
                $definition->setChanges($changes);
                $services[$i] = $definition;
            }
            elseif (!$service instanceof ReferenceConfigurator) {
                throw new InvalidArgumentException(\sprintf('"%s()" expects a list of definitions as returned by "%s()" or "%s()", "%s" given at index "%s" for service "%s".', __METHOD__, InlineServiceConfigurator::FACTORY, ReferenceConfigurator::FACTORY, $service instanceof AbstractConfigurator ? $service::FACTORY . '()' : get_debug_type($service), $i, $id));
            }
        }
        $alias = $this->alias($id, '');
        $alias->definition = $this->set($id)
            ->parent('')
            ->args($services)
            ->tag('container.stack')->definition;
        return $alias;
    }
    
    /**
     * Registers a service.
     */
    public final function __invoke(string $id, ?string $class = null) : ServiceConfigurator {
        return $this->set($id, $class);
    }
    public function __destruct() {
        $this->loader
            ->registerAliasesForSinglyImplementedInterfaces();
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
AbstractConfigurator::$definition protected property @internal
AbstractConfigurator::$valuePreProcessor public static property
AbstractConfigurator::processValue public static function Checks that a value is valid, optionally replacing Definition and Reference configurators by their configure value.
AbstractConfigurator::__call public function
AbstractConfigurator::__sleep public function
AbstractConfigurator::__wakeup public function
ServicesConfigurator::$anonymousCount private property
ServicesConfigurator::$anonymousHash private property
ServicesConfigurator::$defaults private property
ServicesConfigurator::$instanceof private property
ServicesConfigurator::alias final public function Creates an alias.
ServicesConfigurator::defaults final public function Defines a set of defaults for following service definitions.
ServicesConfigurator::FACTORY public constant Overrides AbstractConfigurator::FACTORY
ServicesConfigurator::get final public function Gets an already defined service definition.
ServicesConfigurator::instanceof final public function Defines an instanceof-conditional to be applied to following service definitions.
ServicesConfigurator::load final public function Registers a PSR-4 namespace using a glob pattern.
ServicesConfigurator::remove final public function Removes an already defined service definition or alias.
ServicesConfigurator::set final public function Registers a service.
ServicesConfigurator::stack final public function Registers a stack of decorator services.
ServicesConfigurator::__construct public function
ServicesConfigurator::__destruct public function
ServicesConfigurator::__invoke final public function Registers a service.
RSS feed
Powered by Drupal