ConfigurableExtension
class ConfigurableExtension extends Extension
Этот подкласс расширения обеспечивает первоклассную интеграцию с компонентом Config/Definition.
Вы можете использовать его в качестве базового класса, если
a) вы используете компонент Config/Definition для конфигурации, b) ваш класс конфигурации называется "Configuration", и c) класс конфигурации находится в подпапке DependencyInjection.
Методы
| string | getXsdValidationBasePath() Возвращает базовый путь к файлам XSD. | из Extension |
| string | getNamespace() Возвращает пространство имён, используемое для этого расширения (пространство имён XML). | из Extension |
| string | getAlias() Возвращает рекомендуемый псевдоним для использования в XML. | из Extension |
| ConfigurationInterface|null | getConfiguration(array $config, ContainerBuilder $container) Возвращает конфигурацию расширения. | из Extension |
| array | getClassesToCompile() Получает классы для кеширования. | из Extension |
| addClassesToCompile(array $classes) Добавляет классы в кэш классов. | из Extension | |
| load(array $configs, ContainerBuilder $container) Загружает конкретную конфигурацию. |
Подробности
string getXsdValidationBasePath()
Возвращает базовый путь к файлам XSD.
Значение возврата
| string | Базовый путь к XSD |
string getNamespace()
Возвращает пространство имён, используемое для этого расширения (пространство имён XML).
Значение возврата
| string | Пространство имён XML |
string getAlias()
Возвращает рекомендуемый псевдоним для использования в XML.
Этот псевдоним также является обязательным префиксом при использовании YAML.
Эта конвенция заключается в удалении суффикса "Extension" из имени класса, а затем преобразовании результата в нижний регистр и замене пробелов на нижнее подчеркивание. Например:
AcmeHelloExtension
преобразуется в
acme_hello
Это можно переопределить в подклассе, чтобы вручную указать псевдоним.
Значение возврата
| string | Псевдоним |
Исключения
| BadMethodCallException | Если имя расширения не соответствует соглашениям |
ConfigurationInterface|null getConfiguration(array $config, ContainerBuilder $container)
Возвращает конфигурацию расширения.
Параметры
| array | $config | Массив значений конфигурации |
| ContainerBuilder | $container | Экземпляр ContainerBuilder |
Значение возврата
| ConfigurationInterface|null | Конфигурация или null |
array getClassesToCompile()
Получает классы для кеширования.
Значение возврата
| array | Массив классов |
addClassesToCompile(array $classes)
Добавляет классы в кэш классов.
Параметры
| array | $classes | Массив классов |
final load(array $configs, ContainerBuilder $container)
Загружает конкретную конфигурацию.
Параметры
| array | $configs | |
| ContainerBuilder | $container | Экземпляр ContainerBuilder |
Исключения
| InvalidArgumentException | Если предоставленный тэг не определён в этом расширении |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.1/Symfony/Component/HttpKernel/DependencyInjection/ConfigurableExtension.html
