class XmlFileLoader

XmlFileLoader loads XML routing files.

@author Fabien Potencier <fabien@symfony.com> @author Tobias Schultze <http://tobion.de>

@api

Hierarchy

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

Expanded class hierarchy of XmlFileLoader

2 files declare their use of XmlFileLoader
CustomXmlFileLoader.php in drupal/core/vendor/symfony/routing/Symfony/Component/Routing/Tests/Fixtures/CustomXmlFileLoader.php
XmlFileLoaderTest.php in drupal/core/vendor/symfony/routing/Symfony/Component/Routing/Tests/Loader/XmlFileLoaderTest.php

File

drupal/core/vendor/symfony/routing/Symfony/Component/Routing/Loader/XmlFileLoader.php, line 28

Namespace

Symfony\Component\Routing\Loader
View source
class XmlFileLoader extends FileLoader {
  const NAMESPACE_URI = 'http://symfony.com/schema/routing';
  const SCHEME_PATH = '/schema/routing/routing-1.0.xsd';

  /**
   * Loads an XML file.
   *
   * @param string      $file An XML file path
   * @param string|null $type The resource type
   *
   * @return RouteCollection A RouteCollection instance
   *
   * @throws \InvalidArgumentException When the file cannot be loaded or when the XML cannot be
   *                                   parsed because it does not validate against the scheme.
   *
   * @api
   */
  public function load($file, $type = null) {
    $path = $this->locator
      ->locate($file);
    $xml = $this
      ->loadFile($path);
    $collection = new RouteCollection();
    $collection
      ->addResource(new FileResource($path));

    // process routes and imports
    foreach ($xml->documentElement->childNodes as $node) {
      if (!$node instanceof \DOMElement) {
        continue;
      }
      $this
        ->parseNode($collection, $node, $path, $file);
    }
    return $collection;
  }

  /**
   * Parses a node from a loaded XML file.
   *
   * @param RouteCollection $collection Collection to associate with the node
   * @param \DOMElement     $node       Element to parse
   * @param string          $path       Full path of the XML file being processed
   * @param string          $file       Loaded file name
   *
   * @throws \InvalidArgumentException When the XML is invalid
   */
  protected function parseNode(RouteCollection $collection, \DOMElement $node, $path, $file) {
    if (self::NAMESPACE_URI !== $node->namespaceURI) {
      return;
    }
    switch ($node->localName) {
      case 'route':
        $this
          ->parseRoute($collection, $node, $path);
        break;
      case 'import':
        $this
          ->parseImport($collection, $node, $path, $file);
        break;
      default:
        throw new \InvalidArgumentException(sprintf('Unknown tag "%s" used in file "%s". Expected "route" or "import".', $node->localName, $path));
    }
  }

  /**
   * {@inheritdoc}
   *
   * @api
   */
  public function supports($resource, $type = null) {
    return is_string($resource) && 'xml' === pathinfo($resource, PATHINFO_EXTENSION) && (!$type || 'xml' === $type);
  }

  /**
   * Parses a route and adds it to the RouteCollection.
   *
   * @param RouteCollection $collection RouteCollection instance
   * @param \DOMElement     $node       Element to parse that represents a Route
   * @param string          $path       Full path of the XML file being processed
   *
   * @throws \InvalidArgumentException When the XML is invalid
   */
  protected function parseRoute(RouteCollection $collection, \DOMElement $node, $path) {
    if ('' === ($id = $node
      ->getAttribute('id')) || !$node
      ->hasAttribute('pattern') && !$node
      ->hasAttribute('path')) {
      throw new \InvalidArgumentException(sprintf('The <route> element in file "%s" must have an "id" and a "path" attribute.', $path));
    }
    if ($node
      ->hasAttribute('pattern')) {
      if ($node
        ->hasAttribute('path')) {
        throw new \InvalidArgumentException(sprintf('The <route> element in file "%s" cannot define both a "path" and a "pattern" attribute. Use only "path".', $path));
      }
      $node
        ->setAttribute('path', $node
        ->getAttribute('pattern'));
      $node
        ->removeAttribute('pattern');
    }
    $schemes = preg_split('/[\\s,\\|]++/', $node
      ->getAttribute('schemes'), -1, PREG_SPLIT_NO_EMPTY);
    $methods = preg_split('/[\\s,\\|]++/', $node
      ->getAttribute('methods'), -1, PREG_SPLIT_NO_EMPTY);
    list($defaults, $requirements, $options) = $this
      ->parseConfigs($node, $path);
    $route = new Route($node
      ->getAttribute('path'), $defaults, $requirements, $options, $node
      ->getAttribute('host'), $schemes, $methods);
    $collection
      ->add($id, $route);
  }

  /**
   * Parses an import and adds the routes in the resource to the RouteCollection.
   *
   * @param RouteCollection $collection RouteCollection instance
   * @param \DOMElement     $node       Element to parse that represents a Route
   * @param string          $path       Full path of the XML file being processed
   * @param string          $file       Loaded file name
   *
   * @throws \InvalidArgumentException When the XML is invalid
   */
  protected function parseImport(RouteCollection $collection, \DOMElement $node, $path, $file) {
    if ('' === ($resource = $node
      ->getAttribute('resource'))) {
      throw new \InvalidArgumentException(sprintf('The <import> element in file "%s" must have a "resource" attribute.', $path));
    }
    $type = $node
      ->getAttribute('type');
    $prefix = $node
      ->getAttribute('prefix');
    $host = $node
      ->hasAttribute('host') ? $node
      ->getAttribute('host') : null;
    $schemes = $node
      ->hasAttribute('schemes') ? preg_split('/[\\s,\\|]++/', $node
      ->getAttribute('schemes'), -1, PREG_SPLIT_NO_EMPTY) : null;
    $methods = $node
      ->hasAttribute('methods') ? preg_split('/[\\s,\\|]++/', $node
      ->getAttribute('methods'), -1, PREG_SPLIT_NO_EMPTY) : null;
    list($defaults, $requirements, $options) = $this
      ->parseConfigs($node, $path);
    $this
      ->setCurrentDir(dirname($path));
    $subCollection = $this
      ->import($resource, '' !== $type ? $type : null, false, $file);

    /* @var $subCollection RouteCollection */
    $subCollection
      ->addPrefix($prefix);
    if (null !== $host) {
      $subCollection
        ->setHost($host);
    }
    if (null !== $schemes) {
      $subCollection
        ->setSchemes($schemes);
    }
    if (null !== $methods) {
      $subCollection
        ->setMethods($methods);
    }
    $subCollection
      ->addDefaults($defaults);
    $subCollection
      ->addRequirements($requirements);
    $subCollection
      ->addOptions($options);
    $collection
      ->addCollection($subCollection);
  }

  /**
   * Loads an XML file.
   *
   * @param string $file An XML file path
   *
   * @return \DOMDocument
   *
   * @throws \InvalidArgumentException When loading of XML file fails because of syntax errors
   *                                   or when the XML structure is not as expected by the scheme -
   *                                   see validate()
   */
  protected function loadFile($file) {
    return XmlUtils::loadFile($file, __DIR__ . static::SCHEME_PATH);
  }

  /**
   * Parses the config elements (default, requirement, option).
   *
   * @param \DOMElement $node Element to parse that contains the configs
   * @param string      $path Full path of the XML file being processed
   *
   * @return array An array with the defaults as first item, requirements as second and options as third.
   *
   * @throws \InvalidArgumentException When the XML is invalid
   */
  private function parseConfigs(\DOMElement $node, $path) {
    $defaults = array();
    $requirements = array();
    $options = array();
    foreach ($node
      ->getElementsByTagNameNS(self::NAMESPACE_URI, '*') as $n) {
      switch ($n->localName) {
        case 'default':
          if ($n
            ->hasAttribute('xsi:nil') && 'true' == $n
            ->getAttribute('xsi:nil')) {
            $defaults[$n
              ->getAttribute('key')] = null;
          }
          else {
            $defaults[$n
              ->getAttribute('key')] = trim($n->textContent);
          }
          break;
        case 'requirement':
          $requirements[$n
            ->getAttribute('key')] = trim($n->textContent);
          break;
        case 'option':
          $options[$n
            ->getAttribute('key')] = trim($n->textContent);
          break;
        default:
          throw new \InvalidArgumentException(sprintf('Unknown tag "%s" used in file "%s". Expected "default", "requirement" or "option".', $n->localName, $path));
      }
    }
    return array(
      $defaults,
      $requirements,
      $options,
    );
  }

}

Members

Namesort descending Modifiers Type Description Overrides
XmlFileLoader::load public function Loads an XML file.
XmlFileLoader::loadFile protected function Loads an XML file. 1
XmlFileLoader::NAMESPACE_URI constant
XmlFileLoader::parseConfigs private function Parses the config elements (default, requirement, option).
XmlFileLoader::parseImport protected function Parses an import and adds the routes in the resource to the RouteCollection.
XmlFileLoader::parseNode protected function Parses a node from a loaded XML file.
XmlFileLoader::parseRoute protected function Parses a route and adds it to the RouteCollection.
XmlFileLoader::SCHEME_PATH constant
XmlFileLoader::supports public function @api