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\ConfiguratorView 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. |