4 * This file is part of the Symfony package.
6 * (c) Fabien Potencier <fabien@symfony.com>
8 * For the full copyright and license information, please view the LICENSE
9 * file that was distributed with this source code.
12 namespace Symfony\Component\DependencyInjection\Compiler;
14 use Symfony\Component\DependencyInjection\Definition;
15 use Symfony\Component\DependencyInjection\DefinitionDecorator;
16 use Symfony\Component\DependencyInjection\ContainerBuilder;
17 use Symfony\Component\DependencyInjection\Exception\RuntimeException;
20 * This replaces all DefinitionDecorator instances with their equivalent fully
21 * merged Definition instance.
23 * @author Johannes M. Schmitt <schmittjoh@gmail.com>
24 * @author Nicolas Grekas <p@tchwork.com>
26 class ResolveDefinitionTemplatesPass implements CompilerPassInterface
33 * Process the ContainerBuilder to replace DefinitionDecorator instances with their real Definition instances.
35 * @param ContainerBuilder $container
37 public function process(ContainerBuilder $container)
39 $this->compiler = $container->getCompiler();
40 $this->formatter = $this->compiler->getLoggingFormatter();
42 $container->setDefinitions($this->resolveArguments($container, $container->getDefinitions(), true));
46 * Resolves definition decorator arguments.
48 * @param ContainerBuilder $container The ContainerBuilder
49 * @param array $arguments An array of arguments
50 * @param bool $isRoot If we are processing the root definitions or not
54 private function resolveArguments(ContainerBuilder $container, array $arguments, $isRoot = false)
56 foreach ($arguments as $k => $argument) {
58 // yes, we are specifically fetching the definition from the
59 // container to ensure we are not operating on stale data
60 $arguments[$k] = $argument = $container->getDefinition($k);
61 $this->currentId = $k;
63 if (is_array($argument)) {
64 $arguments[$k] = $this->resolveArguments($container, $argument);
65 } elseif ($argument instanceof Definition) {
66 if ($argument instanceof DefinitionDecorator) {
67 $arguments[$k] = $argument = $this->resolveDefinition($container, $argument);
69 $container->setDefinition($k, $argument);
72 $argument->setArguments($this->resolveArguments($container, $argument->getArguments()));
73 $argument->setMethodCalls($this->resolveArguments($container, $argument->getMethodCalls()));
74 $argument->setProperties($this->resolveArguments($container, $argument->getProperties()));
76 $configurator = $this->resolveArguments($container, array($argument->getConfigurator()));
77 $argument->setConfigurator($configurator[0]);
79 $factory = $this->resolveArguments($container, array($argument->getFactory()));
80 $argument->setFactory($factory[0]);
88 * Resolves the definition.
90 * @param ContainerBuilder $container The ContainerBuilder
91 * @param DefinitionDecorator $definition
95 * @throws \RuntimeException When the definition is invalid
97 private function resolveDefinition(ContainerBuilder $container, DefinitionDecorator $definition)
99 if (!$container->hasDefinition($parent = $definition->getParent())) {
100 throw new RuntimeException(sprintf('The parent definition "%s" defined for definition "%s" does not exist.', $parent, $this->currentId));
103 $parentDef = $container->getDefinition($parent);
104 if ($parentDef instanceof DefinitionDecorator) {
105 $id = $this->currentId;
106 $this->currentId = $parent;
107 $parentDef = $this->resolveDefinition($container, $parentDef);
108 $container->setDefinition($parent, $parentDef);
109 $this->currentId = $id;
112 $this->compiler->addLogMessage($this->formatter->formatResolveInheritance($this, $this->currentId, $parent));
113 $def = new Definition();
115 // merge in parent definition
116 // purposely ignored attributes: scope, abstract, tags
117 $def->setClass($parentDef->getClass());
118 $def->setArguments($parentDef->getArguments());
119 $def->setMethodCalls($parentDef->getMethodCalls());
120 $def->setProperties($parentDef->getProperties());
121 $def->setAutowiringTypes($parentDef->getAutowiringTypes());
122 if ($parentDef->getFactoryClass(false)) {
123 $def->setFactoryClass($parentDef->getFactoryClass(false));
125 if ($parentDef->getFactoryMethod(false)) {
126 $def->setFactoryMethod($parentDef->getFactoryMethod(false));
128 if ($parentDef->getFactoryService(false)) {
129 $def->setFactoryService($parentDef->getFactoryService(false));
131 if ($parentDef->isDeprecated()) {
132 $def->setDeprecated(true, $parentDef->getDeprecationMessage('%service_id%'));
134 $def->setFactory($parentDef->getFactory());
135 $def->setConfigurator($parentDef->getConfigurator());
136 $def->setFile($parentDef->getFile());
137 $def->setPublic($parentDef->isPublic());
138 $def->setLazy($parentDef->isLazy());
139 $def->setAutowired($parentDef->isAutowired());
141 // overwrite with values specified in the decorator
142 $changes = $definition->getChanges();
143 if (isset($changes['class'])) {
144 $def->setClass($definition->getClass());
146 if (isset($changes['factory_class'])) {
147 $def->setFactoryClass($definition->getFactoryClass(false));
149 if (isset($changes['factory_method'])) {
150 $def->setFactoryMethod($definition->getFactoryMethod(false));
152 if (isset($changes['factory_service'])) {
153 $def->setFactoryService($definition->getFactoryService(false));
155 if (isset($changes['factory'])) {
156 $def->setFactory($definition->getFactory());
158 if (isset($changes['configurator'])) {
159 $def->setConfigurator($definition->getConfigurator());
161 if (isset($changes['file'])) {
162 $def->setFile($definition->getFile());
164 if (isset($changes['public'])) {
165 $def->setPublic($definition->isPublic());
167 if (isset($changes['lazy'])) {
168 $def->setLazy($definition->isLazy());
170 if (isset($changes['deprecated'])) {
171 $def->setDeprecated($definition->isDeprecated(), $definition->getDeprecationMessage('%service_id%'));
173 if (isset($changes['autowire'])) {
174 $def->setAutowired($definition->isAutowired());
176 if (isset($changes['decorated_service'])) {
177 $decoratedService = $definition->getDecoratedService();
178 if (null === $decoratedService) {
179 $def->setDecoratedService($decoratedService);
181 $def->setDecoratedService($decoratedService[0], $decoratedService[1], $decoratedService[2]);
186 foreach ($definition->getArguments() as $k => $v) {
187 if (is_numeric($k)) {
188 $def->addArgument($v);
192 if (0 !== strpos($k, 'index_')) {
193 throw new RuntimeException(sprintf('Invalid argument key "%s" found.', $k));
196 $index = (int) substr($k, strlen('index_'));
197 $def->replaceArgument($index, $v);
201 foreach ($definition->getProperties() as $k => $v) {
202 $def->setProperty($k, $v);
205 // append method calls
206 if (count($calls = $definition->getMethodCalls()) > 0) {
207 $def->setMethodCalls(array_merge($def->getMethodCalls(), $calls));
210 // merge autowiring types
211 foreach ($definition->getAutowiringTypes() as $autowiringType) {
212 $def->addAutowiringType($autowiringType);
215 // these attributes are always taken from the child
216 $def->setAbstract($definition->isAbstract());
217 $def->setScope($definition->getScope(false), false);
218 $def->setShared($definition->isShared());
219 $def->setTags($definition->getTags());