Documentation

XmlFileLoader extends FileLoader
in package
uses HostTrait, LocalizedRouteTrait, PrefixTrait

XmlFileLoader loads XML routing files.

Tags
author

Fabien Potencier fabien@symfony.com

author

Tobias Schultze http://tobion.de

Table of Contents

Constants

NAMESPACE_URI  = 'http://symfony.com/schema/routing'
SCHEME_PATH  = '/schema/routing/routing-1.0.xsd'

Properties

$env  : mixed
$loading  : mixed
$locator  : mixed
$resolver  : mixed

Methods

__construct()  : mixed
getLocator()  : FileLocatorInterface
Returns the file locator used by this loader.
getResolver()  : LoaderResolverInterface
Gets the loader resolver.
import()  : mixed
Imports a resource.
load()  : mixed
Loads a resource.
resolve()  : LoaderInterface
Finds a loader able to load an imported resource.
setCurrentDir()  : void
Sets the current directory.
setResolver()  : void
Sets the loader resolver.
supports()  : bool
Returns whether this class supports the given resource.
loadFile()  : DOMDocument
parseImport()  : void
Parses an import and adds the routes in the resource to the RouteCollection.
parseNode()  : void
Parses a node from a loaded XML file.
parseRoute()  : void
Parses a route and adds it to the RouteCollection.
isElementValueNull()  : bool
parseConfigs()  : array<string|int, mixed>
Parses the config elements (default, requirement, option).
parseDefaultNode()  : array<string|int, mixed>|bool|float|int|string|null
Recursively parses the value of a "default" element.
parseDefaultsConfig()  : array<string|int, mixed>|bool|float|int|string|null
Parses the "default" elements.
parseDeprecation()  : array<string|int, mixed>
Parses the deprecation elements.

Constants

NAMESPACE_URI

public mixed NAMESPACE_URI = 'http://symfony.com/schema/routing'

SCHEME_PATH

public mixed SCHEME_PATH = '/schema/routing/routing-1.0.xsd'

Properties

$resolver

protected mixed $resolver

Methods

import()

Imports a resource.

public import(mixed $resource[, string|null $type = null ][, bool $ignoreErrors = false ][, string|null $sourceResource = null ][, string|array<string|int, string>|null $exclude = null ]) : mixed
Parameters
$resource : mixed

A Resource

$type : string|null = null

The resource type or null if unknown

$ignoreErrors : bool = false

Whether to ignore import errors or not

$sourceResource : string|null = null

The original resource importing the new resource

$exclude : string|array<string|int, string>|null = null

Glob patterns to exclude from the import

Tags
throws
LoaderLoadException
throws
FileLoaderImportCircularReferenceException
throws
FileLocatorFileNotFoundException

load()

Loads a resource.

public load(mixed $file[, string|null $type = null ]) : mixed
Parameters
$file : mixed
$type : string|null = null
Tags
throws
InvalidArgumentException

when the file cannot be loaded or when the XML cannot be parsed because it does not validate against the scheme

resolve()

Finds a loader able to load an imported resource.

public resolve(mixed $resource[, string|null $type = null ]) : LoaderInterface
Parameters
$resource : mixed
$type : string|null = null
Tags
throws
LoaderLoadException

If no loader is found

Return values
LoaderInterface

setCurrentDir()

Sets the current directory.

public setCurrentDir(string $dir) : void
Parameters
$dir : string

supports()

Returns whether this class supports the given resource.

public supports(mixed $resource[, string|null $type = null ]) : bool
Parameters
$resource : mixed

A resource

$type : string|null = null
Return values
bool

loadFile()

protected loadFile(string $file) : DOMDocument
Parameters
$file : string
Tags
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()

Return values
DOMDocument

parseImport()

Parses an import and adds the routes in the resource to the RouteCollection.

protected parseImport(RouteCollection $collection, DOMElement $node, string $path, string $file) : void
Parameters
$collection : RouteCollection
$node : DOMElement
$path : string
$file : string
Tags
throws
InvalidArgumentException

When the XML is invalid

parseNode()

Parses a node from a loaded XML file.

protected parseNode(RouteCollection $collection, DOMElement $node, string $path, string $file) : void
Parameters
$collection : RouteCollection
$node : DOMElement
$path : string
$file : string
Tags
throws
InvalidArgumentException

When the XML is invalid

parseRoute()

Parses a route and adds it to the RouteCollection.

protected parseRoute(RouteCollection $collection, DOMElement $node, string $path) : void
Parameters
$collection : RouteCollection
$node : DOMElement
$path : string
Tags
throws
InvalidArgumentException

When the XML is invalid

isElementValueNull()

private isElementValueNull(DOMElement $element) : bool
Parameters
$element : DOMElement
Return values
bool

parseConfigs()

Parses the config elements (default, requirement, option).

private parseConfigs(DOMElement $node, string $path) : array<string|int, mixed>
Parameters
$node : DOMElement
$path : string
Tags
throws
InvalidArgumentException

When the XML is invalid

Return values
array<string|int, mixed>

parseDefaultNode()

Recursively parses the value of a "default" element.

private parseDefaultNode(DOMElement $node, string $path) : array<string|int, mixed>|bool|float|int|string|null
Parameters
$node : DOMElement
$path : string
Tags
throws
InvalidArgumentException

when the XML is invalid

Return values
array<string|int, mixed>|bool|float|int|string|null

parseDefaultsConfig()

Parses the "default" elements.

private parseDefaultsConfig(DOMElement $element, string $path) : array<string|int, mixed>|bool|float|int|string|null
Parameters
$element : DOMElement
$path : string
Return values
array<string|int, mixed>|bool|float|int|string|null

parseDeprecation()

Parses the deprecation elements.

private parseDeprecation(DOMElement $node, string $path) : array<string|int, mixed>
Parameters
$node : DOMElement
$path : string
Tags
throws
InvalidArgumentException

When the XML is invalid

Return values
array<string|int, mixed>

        
On this page

Search results