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

Breadcrumb

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

class XmlFileLoader

Same name in this branch
  1. 11.1.x vendor/symfony/serializer/Mapping/Loader/XmlFileLoader.php \Symfony\Component\Serializer\Mapping\Loader\XmlFileLoader
  2. 11.1.x vendor/symfony/validator/Mapping/Loader/XmlFileLoader.php \Symfony\Component\Validator\Mapping\Loader\XmlFileLoader
  3. 11.1.x vendor/symfony/routing/Loader/XmlFileLoader.php \Symfony\Component\Routing\Loader\XmlFileLoader

XmlFileLoader loads XML files service definitions.

@author Fabien Potencier <fabien@symfony.com>

Hierarchy

  • class \Symfony\Component\DependencyInjection\Loader\FileLoader extends \Symfony\Component\Config\Loader\FileLoader
    • class \Symfony\Component\DependencyInjection\Loader\XmlFileLoader extends \Symfony\Component\DependencyInjection\Loader\FileLoader

Expanded class hierarchy of XmlFileLoader

2 files declare their use of XmlFileLoader
ExtensionTrait.php in vendor/symfony/dependency-injection/Extension/ExtensionTrait.php
Kernel.php in vendor/symfony/http-kernel/Kernel.php

File

vendor/symfony/dependency-injection/Loader/XmlFileLoader.php, line 38

Namespace

Symfony\Component\DependencyInjection\Loader
View source
class XmlFileLoader extends FileLoader {
    public const NS = 'http://symfony.com/schema/dic/services';
    protected bool $autoRegisterAliasesForSinglyImplementedInterfaces = false;
    public function load(mixed $resource, ?string $type = null) : mixed {
        $path = $this->locator
            ->locate($resource);
        $xml = $this->parseFileToDOM($path);
        $this->container
            ->fileExists($path);
        $this->loadXml($xml, $path);
        if ($this->env) {
            $xpath = new \DOMXPath($xml);
            $xpath->registerNamespace('container', self::NS);
            foreach ($xpath->query(\sprintf('//container:when[@env="%s"]', $this->env)) ?: [] as $root) {
                $env = $this->env;
                $this->env = null;
                try {
                    $this->loadXml($xml, $path, $root);
                } finally {
                    $this->env = $env;
                }
            }
        }
        return null;
    }
    private function loadXml(\DOMDocument $xml, string $path, ?\DOMNode $root = null) : void {
        $defaults = $this->getServiceDefaults($xml, $path, $root);
        // anonymous services
        $this->processAnonymousServices($xml, $path, $root);
        // imports
        $this->parseImports($xml, $path, $root);
        // parameters
        $this->parseParameters($xml, $path, $root);
        // extensions
        $this->loadFromExtensions($xml, $root);
        // services
        try {
            $this->parseDefinitions($xml, $path, $defaults, $root);
        } finally {
            $this->instanceof = [];
            $this->registerAliasesForSinglyImplementedInterfaces();
        }
    }
    public function supports(mixed $resource, ?string $type = null) : bool {
        if (!\is_string($resource)) {
            return false;
        }
        if (null === $type && 'xml' === pathinfo($resource, \PATHINFO_EXTENSION)) {
            return true;
        }
        return 'xml' === $type;
    }
    private function parseParameters(\DOMDocument $xml, string $file, ?\DOMNode $root = null) : void {
        if ($parameters = $this->getChildren($root ?? $xml->documentElement, 'parameters')) {
            $this->container
                ->getParameterBag()
                ->add($this->getArgumentsAsPhp($parameters[0], 'parameter', $file));
        }
    }
    private function parseImports(\DOMDocument $xml, string $file, ?\DOMNode $root = null) : void {
        $xpath = new \DOMXPath($xml);
        $xpath->registerNamespace('container', self::NS);
        if (false === ($imports = $xpath->query('./container:imports/container:import', $root))) {
            return;
        }
        $defaultDirectory = \dirname($file);
        foreach ($imports as $import) {
            $this->setCurrentDir($defaultDirectory);
            $this->import($import->getAttribute('resource'), XmlUtils::phpize($import->getAttribute('type')) ?: null, XmlUtils::phpize($import->getAttribute('ignore-errors')) ?: false, $file);
        }
    }
    private function parseDefinitions(\DOMDocument $xml, string $file, Definition $defaults, ?\DOMNode $root = null) : void {
        $xpath = new \DOMXPath($xml);
        $xpath->registerNamespace('container', self::NS);
        if (false === ($services = $xpath->query('./container:services/container:service|./container:services/container:prototype|./container:services/container:stack', $root))) {
            return;
        }
        $this->setCurrentDir(\dirname($file));
        $this->instanceof = [];
        $this->isLoadingInstanceof = true;
        $instanceof = $xpath->query('./container:services/container:instanceof', $root);
        foreach ($instanceof as $service) {
            $this->setDefinition((string) $service->getAttribute('id'), $this->parseDefinition($service, $file, new Definition()));
        }
        $this->isLoadingInstanceof = false;
        foreach ($services as $service) {
            if ('stack' === $service->tagName) {
                $service->setAttribute('parent', '-');
                $definition = $this->parseDefinition($service, $file, $defaults)
                    ->setTags(array_merge_recursive([
                    'container.stack' => [
                        [],
                    ],
                ], $defaults->getTags()));
                $this->setDefinition($id = (string) $service->getAttribute('id'), $definition);
                $stack = [];
                foreach ($this->getChildren($service, 'service') as $k => $frame) {
                    $k = $frame->getAttribute('id') ?: $k;
                    $frame->setAttribute('id', $id . '" at index "' . $k);
                    if ($alias = $frame->getAttribute('alias')) {
                        $this->validateAlias($frame, $file);
                        $stack[$k] = new Reference($alias);
                    }
                    else {
                        $stack[$k] = $this->parseDefinition($frame, $file, $defaults)
                            ->setInstanceofConditionals($this->instanceof);
                    }
                }
                $definition->setArguments($stack);
            }
            elseif (null !== ($definition = $this->parseDefinition($service, $file, $defaults))) {
                if ('prototype' === $service->tagName) {
                    $excludes = array_column($this->getChildren($service, 'exclude'), 'nodeValue');
                    if ($service->hasAttribute('exclude')) {
                        if (\count($excludes) > 0) {
                            throw new InvalidArgumentException('You cannot use both the attribute "exclude" and <exclude> tags at the same time.');
                        }
                        $excludes = [
                            $service->getAttribute('exclude'),
                        ];
                    }
                    $this->registerClasses($definition, (string) $service->getAttribute('namespace'), (string) $service->getAttribute('resource'), $excludes, $file);
                }
                else {
                    $this->setDefinition((string) $service->getAttribute('id'), $definition);
                }
            }
        }
    }
    private function getServiceDefaults(\DOMDocument $xml, string $file, ?\DOMNode $root = null) : Definition {
        $xpath = new \DOMXPath($xml);
        $xpath->registerNamespace('container', self::NS);
        if (null === ($defaultsNode = $xpath->query('./container:services/container:defaults', $root)
            ->item(0))) {
            return new Definition();
        }
        $defaultsNode->setAttribute('id', '<defaults>');
        return $this->parseDefinition($defaultsNode, $file, new Definition());
    }
    
    /**
     * Parses an individual Definition.
     */
    private function parseDefinition(\DOMElement $service, string $file, Definition $defaults) : ?Definition {
        if ($alias = $service->getAttribute('alias')) {
            $this->validateAlias($service, $file);
            $this->container
                ->setAlias($service->getAttribute('id'), $alias = new Alias($alias));
            if ($publicAttr = $service->getAttribute('public')) {
                $alias->setPublic(XmlUtils::phpize($publicAttr));
            }
            elseif ($defaults->getChanges()['public'] ?? false) {
                $alias->setPublic($defaults->isPublic());
            }
            if ($deprecated = $this->getChildren($service, 'deprecated')) {
                $message = $deprecated[0]->nodeValue ?: '';
                $package = $deprecated[0]->getAttribute('package') ?: '';
                $version = $deprecated[0]->getAttribute('version') ?: '';
                if (!$deprecated[0]->hasAttribute('package')) {
                    throw new InvalidArgumentException(\sprintf('Missing attribute "package" at node "deprecated" in "%s".', $file));
                }
                if (!$deprecated[0]->hasAttribute('version')) {
                    throw new InvalidArgumentException(\sprintf('Missing attribute "version" at node "deprecated" in "%s".', $file));
                }
                $alias->setDeprecated($package, $version, $message);
            }
            return null;
        }
        if ($this->isLoadingInstanceof) {
            $definition = new ChildDefinition('');
        }
        elseif ($parent = $service->getAttribute('parent')) {
            $definition = new ChildDefinition($parent);
        }
        else {
            $definition = new Definition();
        }
        if ($defaults->getChanges()['public'] ?? false) {
            $definition->setPublic($defaults->isPublic());
        }
        $definition->setAutowired($defaults->isAutowired());
        $definition->setAutoconfigured($defaults->isAutoconfigured());
        $definition->setChanges([]);
        foreach ([
            'class',
            'public',
            'shared',
            'synthetic',
            'abstract',
        ] as $key) {
            if ($value = $service->getAttribute($key)) {
                $method = 'set' . $key;
                $definition->{$method}(XmlUtils::phpize($value));
            }
        }
        if ($value = $service->getAttribute('lazy')) {
            $definition->setLazy((bool) ($value = XmlUtils::phpize($value)));
            if (\is_string($value)) {
                $definition->addTag('proxy', [
                    'interface' => $value,
                ]);
            }
        }
        if ($value = $service->getAttribute('autowire')) {
            $definition->setAutowired(XmlUtils::phpize($value));
        }
        if ($value = $service->getAttribute('autoconfigure')) {
            $definition->setAutoconfigured(XmlUtils::phpize($value));
        }
        if ($files = $this->getChildren($service, 'file')) {
            $definition->setFile($files[0]->nodeValue);
        }
        if ($deprecated = $this->getChildren($service, 'deprecated')) {
            $message = $deprecated[0]->nodeValue ?: '';
            $package = $deprecated[0]->getAttribute('package') ?: '';
            $version = $deprecated[0]->getAttribute('version') ?: '';
            if (!$deprecated[0]->hasAttribute('package')) {
                throw new InvalidArgumentException(\sprintf('Missing attribute "package" at node "deprecated" in "%s".', $file));
            }
            if (!$deprecated[0]->hasAttribute('version')) {
                throw new InvalidArgumentException(\sprintf('Missing attribute "version" at node "deprecated" in "%s".', $file));
            }
            $definition->setDeprecated($package, $version, $message);
        }
        $definition->setArguments($this->getArgumentsAsPhp($service, 'argument', $file, $definition instanceof ChildDefinition));
        $definition->setProperties($this->getArgumentsAsPhp($service, 'property', $file));
        if ($factories = $this->getChildren($service, 'factory')) {
            $factory = $factories[0];
            if ($function = $factory->getAttribute('function')) {
                $definition->setFactory($function);
            }
            elseif ($expression = $factory->getAttribute('expression')) {
                if (!class_exists(Expression::class)) {
                    throw new \LogicException('The "expression" attribute cannot be used on factories without the ExpressionLanguage component. Try running "composer require symfony/expression-language".');
                }
                $definition->setFactory('@=' . $expression);
            }
            else {
                if ($childService = $factory->getAttribute('service')) {
                    $class = new Reference($childService, ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE);
                }
                else {
                    $class = $factory->hasAttribute('class') ? $factory->getAttribute('class') : null;
                }
                $definition->setFactory([
                    $class,
                    $factory->getAttribute('method') ?: '__invoke',
                ]);
            }
        }
        if ($constructor = $service->getAttribute('constructor')) {
            if (null !== $definition->getFactory()) {
                throw new LogicException(\sprintf('The "%s" service cannot declare a factory as well as a constructor.', $service->getAttribute('id')));
            }
            $definition->setFactory([
                null,
                $constructor,
            ]);
        }
        if ($configurators = $this->getChildren($service, 'configurator')) {
            $configurator = $configurators[0];
            if ($function = $configurator->getAttribute('function')) {
                $definition->setConfigurator($function);
            }
            else {
                if ($childService = $configurator->getAttribute('service')) {
                    $class = new Reference($childService, ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE);
                }
                else {
                    $class = $configurator->getAttribute('class');
                }
                $definition->setConfigurator([
                    $class,
                    $configurator->getAttribute('method') ?: '__invoke',
                ]);
            }
        }
        foreach ($this->getChildren($service, 'call') as $call) {
            $definition->addMethodCall($call->getAttribute('method'), $this->getArgumentsAsPhp($call, 'argument', $file), XmlUtils::phpize($call->getAttribute('returns-clone')));
        }
        $tags = $this->getChildren($service, 'tag');
        foreach ($tags as $tag) {
            $tagNameComesFromAttribute = $tag->childElementCount || '' === $tag->nodeValue;
            if ('' === ($tagName = $tagNameComesFromAttribute ? $tag->getAttribute('name') : $tag->nodeValue)) {
                throw new InvalidArgumentException(\sprintf('The tag name for service "%s" in "%s" must be a non-empty string.', $service->getAttribute('id'), $file));
            }
            $parameters = $this->getTagAttributes($tag, \sprintf('The attribute name of tag "%s" for service "%s" in %s must be a non-empty string.', $tagName, $service->getAttribute('id'), $file));
            foreach ($tag->attributes as $name => $node) {
                if ($tagNameComesFromAttribute && 'name' === $name) {
                    continue;
                }
                if (str_contains($name, '-') && !str_contains($name, '_') && !\array_key_exists($normalizedName = str_replace('-', '_', $name), $parameters)) {
                    $parameters[$normalizedName] = XmlUtils::phpize($node->nodeValue);
                }
                // keep not normalized key
                $parameters[$name] = XmlUtils::phpize($node->nodeValue);
            }
            $definition->addTag($tagName, $parameters);
        }
        $definition->setTags(array_merge_recursive($definition->getTags(), $defaults->getTags()));
        $bindings = $this->getArgumentsAsPhp($service, 'bind', $file);
        $bindingType = $this->isLoadingInstanceof ? BoundArgument::INSTANCEOF_BINDING : BoundArgument::SERVICE_BINDING;
        foreach ($bindings as $argument => $value) {
            $bindings[$argument] = new BoundArgument($value, true, $bindingType, $file);
        }
        // deep clone, to avoid multiple process of the same instance in the passes
        $bindings = array_merge(unserialize(serialize($defaults->getBindings())), $bindings);
        if ($bindings) {
            $definition->setBindings($bindings);
        }
        if ($decorates = $service->getAttribute('decorates')) {
            $decorationOnInvalid = $service->getAttribute('decoration-on-invalid') ?: 'exception';
            if ('exception' === $decorationOnInvalid) {
                $invalidBehavior = ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE;
            }
            elseif ('ignore' === $decorationOnInvalid) {
                $invalidBehavior = ContainerInterface::IGNORE_ON_INVALID_REFERENCE;
            }
            elseif ('null' === $decorationOnInvalid) {
                $invalidBehavior = ContainerInterface::NULL_ON_INVALID_REFERENCE;
            }
            else {
                throw new InvalidArgumentException(\sprintf('Invalid value "%s" for attribute "decoration-on-invalid" on service "%s". Did you mean "exception", "ignore" or "null" in "%s"?', $decorationOnInvalid, $service->getAttribute('id'), $file));
            }
            $renameId = $service->hasAttribute('decoration-inner-name') ? $service->getAttribute('decoration-inner-name') : null;
            $priority = $service->hasAttribute('decoration-priority') ? $service->getAttribute('decoration-priority') : 0;
            $definition->setDecoratedService($decorates, $renameId, $priority, $invalidBehavior);
        }
        if ($callable = $this->getChildren($service, 'from-callable')) {
            if ($definition instanceof ChildDefinition) {
                throw new InvalidArgumentException(\sprintf('Attribute "parent" is unsupported when using "<from-callable>" on service "%s".', $service->getAttribute('id')));
            }
            foreach ([
                'Attribute "synthetic"' => 'isSynthetic',
                'Attribute "file"' => 'getFile',
                'Tag "<factory>"' => 'getFactory',
                'Tag "<argument>"' => 'getArguments',
                'Tag "<property>"' => 'getProperties',
                'Tag "<configurator>"' => 'getConfigurator',
                'Tag "<call>"' => 'getMethodCalls',
            ] as $key => $method) {
                if ($definition->{$method}()) {
                    throw new InvalidArgumentException($key . \sprintf(' is unsupported when using "<from-callable>" on service "%s".', $service->getAttribute('id')));
                }
            }
            $definition->setFactory([
                'Closure',
                'fromCallable',
            ]);
            if ('Closure' !== ($definition->getClass() ?? 'Closure')) {
                $definition->setLazy(true);
            }
            else {
                $definition->setClass('Closure');
            }
            $callable = $callable[0];
            if ($function = $callable->getAttribute('function')) {
                $definition->setArguments([
                    $function,
                ]);
            }
            elseif ($expression = $callable->getAttribute('expression')) {
                if (!class_exists(Expression::class)) {
                    throw new \LogicException('The "expression" attribute cannot be used without the ExpressionLanguage component. Try running "composer require symfony/expression-language".');
                }
                $definition->setArguments([
                    '@=' . $expression,
                ]);
            }
            else {
                if ($childService = $callable->getAttribute('service')) {
                    $class = new Reference($childService, ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE);
                }
                else {
                    $class = $callable->hasAttribute('class') ? $callable->getAttribute('class') : null;
                }
                $definition->setArguments([
                    [
                        $class,
                        $callable->getAttribute('method') ?: '__invoke',
                    ],
                ]);
            }
        }
        return $definition;
    }
    
    /**
     * Parses an XML file to a \DOMDocument.
     *
     * @throws InvalidArgumentException When loading of XML file returns error
     */
    private function parseFileToDOM(string $file) : \DOMDocument {
        try {
            $dom = XmlUtils::loadFile($file, $this->validateSchema(...));
        } catch (\InvalidArgumentException $e) {
            $invalidSecurityElements = [];
            $errors = explode("\n", $e->getMessage());
            foreach ($errors as $i => $error) {
                if (preg_match("#^\\[ERROR 1871] Element '\\{http://symfony\\.com/schema/dic/security}([^']+)'#", $error, $matches)) {
                    $invalidSecurityElements[$i] = $matches[1];
                }
            }
            if ($invalidSecurityElements) {
                $dom = XmlUtils::loadFile($file);
                foreach ($invalidSecurityElements as $errorIndex => $tagName) {
                    foreach ($dom->getElementsByTagNameNS('http://symfony.com/schema/dic/security', $tagName) as $element) {
                        if (!($parent = $element->parentNode)) {
                            continue;
                        }
                        if ('http://symfony.com/schema/dic/security' !== $parent->namespaceURI) {
                            continue;
                        }
                        if ('provider' === $parent->localName || 'firewall' === $parent->localName) {
                            unset($errors[$errorIndex]);
                        }
                    }
                }
            }
            if ($errors) {
                throw new InvalidArgumentException(\sprintf('Unable to parse file "%s": ', $file) . implode("\n", $errors), $e->getCode(), $e);
            }
        }
        $this->validateExtensions($dom, $file);
        return $dom;
    }
    
    /**
     * Processes anonymous services.
     */
    private function processAnonymousServices(\DOMDocument $xml, string $file, ?\DOMNode $root = null) : void {
        $definitions = [];
        $count = 0;
        $suffix = '~' . ContainerBuilder::hash($file);
        $xpath = new \DOMXPath($xml);
        $xpath->registerNamespace('container', self::NS);
        // anonymous services as arguments/properties
        if (false !== ($nodes = $xpath->query('.//container:argument[@type="service"][not(@id)]|.//container:property[@type="service"][not(@id)]|.//container:bind[not(@id)]|.//container:factory[not(@service)]|.//container:configurator[not(@service)]', $root))) {
            foreach ($nodes as $node) {
                if ($services = $this->getChildren($node, 'service')) {
                    // give it a unique name
                    $id = \sprintf('.%d_%s', ++$count, preg_replace('/^.*\\\\/', '', $services[0]->getAttribute('class')) . $suffix);
                    $node->setAttribute('id', $id);
                    $node->setAttribute('service', $id);
                    $definitions[$id] = [
                        $services[0],
                        $file,
                    ];
                    $services[0]->setAttribute('id', $id);
                    // anonymous services are always private
                    // we could not use the constant false here, because of XML parsing
                    $services[0]->setAttribute('public', 'false');
                }
            }
        }
        // anonymous services "in the wild"
        if (false !== ($nodes = $xpath->query('.//container:services/container:service[not(@id)]', $root))) {
            foreach ($nodes as $node) {
                throw new InvalidArgumentException(\sprintf('Top-level services must have "id" attribute, none found in "%s" at line %d.', $file, $node->getLineNo()));
            }
        }
        // resolve definitions
        uksort($definitions, 'strnatcmp');
        foreach (array_reverse($definitions) as $id => [
            $domElement,
            $file,
        ]) {
            if (null !== ($definition = $this->parseDefinition($domElement, $file, new Definition()))) {
                $this->setDefinition($id, $definition);
            }
        }
    }
    private function getArgumentsAsPhp(\DOMElement $node, string $name, string $file, bool $isChildDefinition = false) : array {
        $arguments = [];
        foreach ($this->getChildren($node, $name) as $arg) {
            if ($arg->hasAttribute('name')) {
                $arg->setAttribute('key', $arg->getAttribute('name'));
            }
            // this is used by ChildDefinition to overwrite a specific
            // argument of the parent definition
            if ($arg->hasAttribute('index')) {
                $key = ($isChildDefinition ? 'index_' : '') . $arg->getAttribute('index');
            }
            elseif (!$arg->hasAttribute('key')) {
                // Append an empty argument, then fetch its key to overwrite it later
                $arguments[] = null;
                $keys = array_keys($arguments);
                $key = array_pop($keys);
            }
            else {
                $key = $arg->getAttribute('key');
            }
            switch ($arg->getAttribute('key-type')) {
                case 'binary':
                    if (false === ($key = base64_decode($key, true))) {
                        throw new InvalidArgumentException(\sprintf('Tag "<%s>" with key-type="binary" does not have a valid base64 encoded key in "%s".', $name, $file));
                    }
                    break;
                case 'constant':
                    try {
                        $key = \constant(trim($key));
                    } catch (\Error) {
                        throw new InvalidArgumentException(\sprintf('The key "%s" is not a valid constant in "%s".', $key, $file));
                    }
                    break;
            }
            $trim = $arg->hasAttribute('trim') && XmlUtils::phpize($arg->getAttribute('trim'));
            $onInvalid = $arg->getAttribute('on-invalid');
            $invalidBehavior = ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE;
            if ('ignore' == $onInvalid) {
                $invalidBehavior = ContainerInterface::IGNORE_ON_INVALID_REFERENCE;
            }
            elseif ('ignore_uninitialized' == $onInvalid) {
                $invalidBehavior = ContainerInterface::IGNORE_ON_UNINITIALIZED_REFERENCE;
            }
            elseif ('null' == $onInvalid) {
                $invalidBehavior = ContainerInterface::NULL_ON_INVALID_REFERENCE;
            }
            switch ($type = $arg->getAttribute('type')) {
                case 'service':
                    if ('' === $arg->getAttribute('id')) {
                        throw new InvalidArgumentException(\sprintf('Tag "<%s>" with type="service" has no or empty "id" attribute in "%s".', $name, $file));
                    }
                    $arguments[$key] = new Reference($arg->getAttribute('id'), $invalidBehavior);
                    break;
                case 'expression':
                    if (!class_exists(Expression::class)) {
                        throw new \LogicException('The type="expression" attribute cannot be used without the ExpressionLanguage component. Try running "composer require symfony/expression-language".');
                    }
                    $arguments[$key] = new Expression($arg->nodeValue);
                    break;
                case 'collection':
                    $arguments[$key] = $this->getArgumentsAsPhp($arg, $name, $file);
                    break;
                case 'iterator':
                    $arg = $this->getArgumentsAsPhp($arg, $name, $file);
                    $arguments[$key] = new IteratorArgument($arg);
                    break;
                case 'closure':
                case 'service_closure':
                    if ('' !== $arg->getAttribute('id')) {
                        $arg = new Reference($arg->getAttribute('id'), $invalidBehavior);
                    }
                    else {
                        $arg = $this->getArgumentsAsPhp($arg, $name, $file);
                    }
                    $arguments[$key] = match ($type) {    'service_closure' => new ServiceClosureArgument($arg),
                        'closure' => (new Definition('Closure'))->setFactory([
                            'Closure',
                            'fromCallable',
                        ])
                            ->addArgument($arg),
                    
                    };
                    break;
                case 'service_locator':
                    $arg = $this->getArgumentsAsPhp($arg, $name, $file);
                    $arguments[$key] = new ServiceLocatorArgument($arg);
                    break;
                case 'tagged':
                    trigger_deprecation('symfony/dependency-injection', '7.2', 'Type "tagged" is deprecated for tag <%s>, use "tagged_iterator" instead in "%s".', $name, $file);
                // no break
                case 'tagged_iterator':
                case 'tagged_locator':
                    $forLocator = 'tagged_locator' === $type;
                    if (!$arg->getAttribute('tag')) {
                        throw new InvalidArgumentException(\sprintf('Tag "<%s>" with type="%s" has no or empty "tag" attribute in "%s".', $name, $type, $file));
                    }
                    $excludes = array_column($this->getChildren($arg, 'exclude'), 'nodeValue');
                    if ($arg->hasAttribute('exclude')) {
                        if (\count($excludes) > 0) {
                            throw new InvalidArgumentException('You cannot use both the attribute "exclude" and <exclude> tags at the same time.');
                        }
                        $excludes = [
                            $arg->getAttribute('exclude'),
                        ];
                    }
                    $arguments[$key] = new TaggedIteratorArgument($arg->getAttribute('tag'), $arg->getAttribute('index-by') ?: null, $arg->getAttribute('default-index-method') ?: null, $forLocator, $arg->getAttribute('default-priority-method') ?: null, $excludes, !$arg->hasAttribute('exclude-self') || XmlUtils::phpize($arg->getAttribute('exclude-self')));
                    if ($forLocator) {
                        $arguments[$key] = new ServiceLocatorArgument($arguments[$key]);
                    }
                    break;
                case 'binary':
                    if (false === ($value = base64_decode($arg->nodeValue))) {
                        throw new InvalidArgumentException(\sprintf('Tag "<%s>" with type="binary" is not a valid base64 encoded string.', $name));
                    }
                    $arguments[$key] = $value;
                    break;
                case 'abstract':
                    $arguments[$key] = new AbstractArgument($arg->nodeValue);
                    break;
                case 'string':
                    $arguments[$key] = $trim ? trim($arg->nodeValue) : $arg->nodeValue;
                    break;
                case 'constant':
                    $arguments[$key] = \constant(trim($arg->nodeValue));
                    break;
                default:
                    $arguments[$key] = XmlUtils::phpize($trim ? trim($arg->nodeValue) : $arg->nodeValue);
            }
        }
        return $arguments;
    }
    
    /**
     * Get child elements by name.
     *
     * @return \DOMElement[]
     */
    private function getChildren(\DOMNode $node, string $name) : array {
        $children = [];
        foreach ($node->childNodes as $child) {
            if ($child instanceof \DOMElement && $child->localName === $name && self::NS === $child->namespaceURI) {
                $children[] = $child;
            }
        }
        return $children;
    }
    private function getTagAttributes(\DOMNode $node, string $missingName) : array {
        $parameters = [];
        $children = $this->getChildren($node, 'attribute');
        foreach ($children as $childNode) {
            if ('' === ($name = $childNode->getAttribute('name'))) {
                throw new InvalidArgumentException($missingName);
            }
            if ($this->getChildren($childNode, 'attribute')) {
                $parameters[$name] = $this->getTagAttributes($childNode, $missingName);
            }
            else {
                if (str_contains($name, '-') && !str_contains($name, '_') && !\array_key_exists($normalizedName = str_replace('-', '_', $name), $parameters)) {
                    $parameters[$normalizedName] = XmlUtils::phpize($childNode->nodeValue);
                }
                // keep not normalized key
                $parameters[$name] = XmlUtils::phpize($childNode->nodeValue);
            }
        }
        return $parameters;
    }
    
    /**
     * Validates a documents XML schema.
     *
     * @throws RuntimeException When extension references a non-existent XSD file
     */
    public function validateSchema(\DOMDocument $dom) : bool {
        $schemaLocations = [
            'http://symfony.com/schema/dic/services' => str_replace('\\', '/', __DIR__ . '/schema/dic/services/services-1.0.xsd'),
        ];
        if ($element = $dom->documentElement
            ->getAttributeNS('http://www.w3.org/2001/XMLSchema-instance', 'schemaLocation')) {
            $items = preg_split('/\\s+/', $element);
            for ($i = 0, $nb = \count($items); $i < $nb; $i += 2) {
                if (!$this->container
                    ->hasExtension($items[$i])) {
                    continue;
                }
                if (($extension = $this->container
                    ->getExtension($items[$i])) && false !== $extension->getXsdValidationBasePath()) {
                    $ns = $extension->getNamespace();
                    $path = str_replace([
                        $ns,
                        str_replace('http://', 'https://', $ns),
                    ], str_replace('\\', '/', $extension->getXsdValidationBasePath()) . '/', $items[$i + 1]);
                    if (!is_file($path)) {
                        throw new RuntimeException(\sprintf('Extension "%s" references a non-existent XSD file "%s".', get_debug_type($extension), $path));
                    }
                    $schemaLocations[$items[$i]] = $path;
                }
            }
        }
        $tmpfiles = [];
        $imports = '';
        foreach ($schemaLocations as $namespace => $location) {
            $parts = explode('/', $location);
            $locationstart = 'file:///';
            if (0 === stripos($location, 'phar://')) {
                $tmpfile = tempnam(sys_get_temp_dir(), 'symfony');
                if ($tmpfile) {
                    copy($location, $tmpfile);
                    $tmpfiles[] = $tmpfile;
                    $parts = explode('/', str_replace('\\', '/', $tmpfile));
                }
                else {
                    array_shift($parts);
                    $locationstart = 'phar:///';
                }
            }
            elseif ('\\' === \DIRECTORY_SEPARATOR && str_starts_with($location, '\\\\')) {
                $locationstart = '';
            }
            $drive = '\\' === \DIRECTORY_SEPARATOR ? array_shift($parts) . '/' : '';
            $location = $locationstart . $drive . implode('/', array_map('rawurlencode', $parts));
            $imports .= \sprintf('  <xsd:import namespace="%s" schemaLocation="%s" />' . "\n", $namespace, $location);
        }
        $source = <<<EOF
<?xml version="1.0" encoding="utf-8" ?>
<xsd:schema xmlns="http://symfony.com/schema"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    targetNamespace="http://symfony.com/schema"
    elementFormDefault="qualified">

    <xsd:import namespace="http://www.w3.org/XML/1998/namespace"/>
{<span class="php-variable">$imports</span>}
</xsd:schema>
EOF;
        if ($this->shouldEnableEntityLoader()) {
            $disableEntities = libxml_disable_entity_loader(false);
            $valid = @$dom->schemaValidateSource($source);
            libxml_disable_entity_loader($disableEntities);
        }
        else {
            $valid = @$dom->schemaValidateSource($source);
        }
        foreach ($tmpfiles as $tmpfile) {
            @unlink($tmpfile);
        }
        return $valid;
    }
    private function shouldEnableEntityLoader() : bool {
        static $dom, $schema;
        if (null === $dom) {
            $dom = new \DOMDocument();
            $dom->loadXML('<?xml version="1.0"?><test/>');
            $tmpfile = tempnam(sys_get_temp_dir(), 'symfony');
            register_shutdown_function(static function () use ($tmpfile) {
                @unlink($tmpfile);
            });
            $schema = '<?xml version="1.0" encoding="utf-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <xsd:include schemaLocation="file:///' . rawurlencode(str_replace('\\', '/', $tmpfile)) . '" />
</xsd:schema>';
            file_put_contents($tmpfile, '<?xml version="1.0" encoding="utf-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <xsd:element name="test" type="testType" />
  <xsd:complexType name="testType"/>
</xsd:schema>');
        }
        return !@$dom->schemaValidateSource($schema);
    }
    private function validateAlias(\DOMElement $alias, string $file) : void {
        foreach ($alias->attributes as $name => $node) {
            if (!\in_array($name, [
                'alias',
                'id',
                'public',
            ])) {
                throw new InvalidArgumentException(\sprintf('Invalid attribute "%s" defined for alias "%s" in "%s".', $name, $alias->getAttribute('id'), $file));
            }
        }
        foreach ($alias->childNodes as $child) {
            if (!$child instanceof \DOMElement || self::NS !== $child->namespaceURI) {
                continue;
            }
            if ('deprecated' !== $child->localName) {
                throw new InvalidArgumentException(\sprintf('Invalid child element "%s" defined for alias "%s" in "%s".', $child->localName, $alias->getAttribute('id'), $file));
            }
        }
    }
    
    /**
     * Validates an extension.
     *
     * @throws InvalidArgumentException When no extension is found corresponding to a tag
     */
    private function validateExtensions(\DOMDocument $dom, string $file) : void {
        foreach ($dom->documentElement->childNodes as $node) {
            if (!$node instanceof \DOMElement || 'http://symfony.com/schema/dic/services' === $node->namespaceURI) {
                continue;
            }
            // can it be handled by an extension?
            if (!$this->prepend && !$this->container
                ->hasExtension($node->namespaceURI)) {
                $extensionNamespaces = array_filter(array_map(fn(ExtensionInterface $ext) => $ext->getNamespace(), $this->container
                    ->getExtensions()));
                throw new InvalidArgumentException(UndefinedExtensionHandler::getErrorMessage($node->tagName, $file, $node->namespaceURI, $extensionNamespaces));
            }
        }
    }
    
    /**
     * Loads from an extension.
     */
    private function loadFromExtensions(\DOMDocument $xml) : void {
        foreach ($xml->documentElement->childNodes as $node) {
            if (!$node instanceof \DOMElement || self::NS === $node->namespaceURI) {
                continue;
            }
            $values = static::convertDomElementToArray($node);
            if (!\is_array($values)) {
                $values = [];
            }
            $this->loadExtensionConfig($node->namespaceURI, $values);
        }
        $this->loadExtensionConfigs();
    }
    
    /**
     * Converts a \DOMElement object to a PHP array.
     *
     * The following rules applies during the conversion:
     *
     *  * Each tag is converted to a key value or an array
     *    if there is more than one "value"
     *
     *  * The content of a tag is set under a "value" key (<foo>bar</foo>)
     *    if the tag also has some nested tags
     *
     *  * The attributes are converted to keys (<foo foo="bar"/>)
     *
     *  * The nested-tags are converted to keys (<foo><foo>bar</foo></foo>)
     *
     * @param \DOMElement $element A \DOMElement instance
     */
    public static function convertDomElementToArray(\DOMElement $element) : mixed {
        return XmlUtils::convertDomElementToArray($element, false);
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
FileLoader::$aliases protected property @var array&lt;string, Alias&gt;
FileLoader::$extensionConfigs protected property
FileLoader::$importing protected property
FileLoader::$instanceof protected property
FileLoader::$interfaces protected property
FileLoader::$isLoadingInstanceof protected property
FileLoader::$singlyImplemented protected property
FileLoader::addContainerExcludedTag private function
FileLoader::ANONYMOUS_ID_REGEXP public constant
FileLoader::findClasses private function
FileLoader::import public function
FileLoader::loadExtensionConfig final protected function
FileLoader::loadExtensionConfigs final protected function
FileLoader::registerAliasesForSinglyImplementedInterfaces public function
FileLoader::registerClasses public function Registers a set of classes as services using PSR-4 for discovery.
FileLoader::setDefinition protected function Registers a definition in the container with its instanceof-conditionals.
FileLoader::__construct public function 1
XmlFileLoader::$autoRegisterAliasesForSinglyImplementedInterfaces protected property Overrides FileLoader::$autoRegisterAliasesForSinglyImplementedInterfaces
XmlFileLoader::convertDomElementToArray public static function Converts a \DOMElement object to a PHP array.
XmlFileLoader::getArgumentsAsPhp private function
XmlFileLoader::getChildren private function Get child elements by name.
XmlFileLoader::getServiceDefaults private function
XmlFileLoader::getTagAttributes private function
XmlFileLoader::load public function
XmlFileLoader::loadFromExtensions private function Loads from an extension.
XmlFileLoader::loadXml private function
XmlFileLoader::NS public constant
XmlFileLoader::parseDefinition private function Parses an individual Definition.
XmlFileLoader::parseDefinitions private function
XmlFileLoader::parseFileToDOM private function Parses an XML file to a \DOMDocument.
XmlFileLoader::parseImports private function
XmlFileLoader::parseParameters private function
XmlFileLoader::processAnonymousServices private function Processes anonymous services.
XmlFileLoader::shouldEnableEntityLoader private function
XmlFileLoader::supports public function
XmlFileLoader::validateAlias private function
XmlFileLoader::validateExtensions private function Validates an extension.
XmlFileLoader::validateSchema public function Validates a documents XML schema.
RSS feed
Powered by Drupal