abstract class Extension implements ExtensionInterface, ConfigurationExtensionInterface

Provides useful features shared by many extensions.

Methods

string
getXsdValidationBasePath()

Returns the base path for the XSD files.

string
getNamespace()

Returns the namespace to be used for this extension (XML namespace).

string
getAlias()

Returns the recommended alias to use in XML.

getConfiguration(array $config, ContainerBuilder $container)

Returns extension configuration.

processConfiguration(ConfigurationInterface $configuration, array $configs)

No description

getProcessedConfigs()

No description

bool
isConfigEnabled(ContainerBuilder $container, array $config)

No description

Details

string getXsdValidationBasePath()

Returns the base path for the XSD files.

Return Value

string The XSD base path

string getNamespace()

Returns the namespace to be used for this extension (XML namespace).

Return Value

string The XML namespace

string getAlias()

Returns the recommended alias to use in XML.

This alias is also the mandatory prefix to use when using YAML.

This convention is to remove the "Extension" postfix from the class name and then lowercase and underscore the result. So:

AcmeHelloExtension

becomes

acme_hello

This can be overridden in a sub-class to specify the alias manually.

Return Value

string The alias

Exceptions

BadMethodCallException When the extension name does not follow conventions

ConfigurationInterface|null getConfiguration(array $config, ContainerBuilder $container)

Returns extension configuration.

Parameters

array $config
ContainerBuilder $container

Return Value

ConfigurationInterface|null The configuration or null

final protected processConfiguration(ConfigurationInterface $configuration, array $configs)

Parameters

ConfigurationInterface $configuration
array $configs

final getProcessedConfigs()

protected bool isConfigEnabled(ContainerBuilder $container, array $config)

Parameters

ContainerBuilder $container
array $config

Return Value

bool Whether the configuration is enabled

Exceptions

InvalidArgumentException When the config is not enableable