VariableNodeDefinition
class VariableNodeDefinition extends NodeDefinition
Этот класс предоставляет удобный интерфейс для определения узла.
Свойства
| protected | $name | из NodeDefinition | |
| protected | $normalization | из NodeDefinition | |
| protected | $validation | из NodeDefinition | |
| protected | $defaultValue | из NodeDefinition | |
| protected | $default | из NodeDefinition | |
| protected | $required | из NodeDefinition | |
| protected | $deprecationMessage | из NodeDefinition | |
| protected | $merge | из NodeDefinition | |
| protected | $allowEmptyValue | из NodeDefinition | |
| protected | $nullEquivalent | из NodeDefinition | |
| protected | $trueEquivalent | из NodeDefinition | |
| protected | $falseEquivalent | из NodeDefinition | |
| protected | $pathSeparator | из NodeDefinition | |
| protected | $parent | из NodeDefinition | |
| protected | $attributes | из NodeDefinition |
Методы
| __construct(string|null $name, NodeParentInterface $parent = null) | from NodeDefinition | |
| $this | setParent(NodeParentInterface $parent) Устанавливает родительский узел. | from NodeDefinition |
| $this | info(string $info) Устанавливает сообщение информации. | from NodeDefinition |
| $this | example(string|array $example) Устанавливает пример конфигурации. | from NodeDefinition |
| $this | attribute(string $key, mixed $value) Устанавливает атрибут узла. | from NodeDefinition |
| NodeParentInterface|NodeBuilder|NodeDefinition|ArrayNodeDefinition|VariableNodeDefinition|null | end() Возвращает родительский узел. | from NodeDefinition |
| NodeInterface | getNode(bool $forceRootNode = false) Создаёт узел. | from NodeDefinition |
| $this | defaultValue(mixed $value) Устанавливает значение по умолчанию. | from NodeDefinition |
| $this | isRequired() Устанавливает узел как обязательный. | from NodeDefinition |
| $this | setDeprecated(string $message = 'The child node "%node%" at path "%path%" is deprecated.') Устанавливает узел как устаревший. | from NodeDefinition |
| $this | treatNullLike(mixed $value) Устанавливает эквивалентное значение, используемое, когда узел содержит null. | from NodeDefinition |
| $this | treatTrueLike(mixed $value) Устанавливает эквивалентное значение, используемое, когда узел содержит true. | from NodeDefinition |
| $this | treatFalseLike(mixed $value) Устанавливает эквивалентное значение, используемое, когда узел содержит false. | from NodeDefinition |
| $this | defaultNull() Устанавливает null в качестве значения по умолчанию. | from NodeDefinition |
| $this | defaultTrue() Устанавливает true в качестве значения по умолчанию. | from NodeDefinition |
| $this | defaultFalse() Устанавливает false в качестве значения по умолчанию. | from NodeDefinition |
| ExprBuilder | beforeNormalization() Устанавливает выражение, выполняемое перед нормализацией. | from NodeDefinition |
| $this | cannotBeEmpty() Запрещает пустое значение узла. | from NodeDefinition |
| ExprBuilder | validate() Устанавливает выражение для проверки. | from NodeDefinition |
| $this | cannotBeOverwritten(bool $deny = true) Устанавливает, можно ли перезаписать узел. | from NodeDefinition |
| ValidationBuilder | validation() Получает конструктор для правил валидации. | from NodeDefinition |
| MergeBuilder | merge() Получает конструктор для правил слияния. | from NodeDefinition |
| NormalizationBuilder | normalization() Получает конструктор для правил нормализации. | from NodeDefinition |
| NodeInterface | createNode() Инициализирует и настраивает узел в соответствии с этим определением. | |
| $this | setPathSeparator(string $separator) Установить разделитель пути. | from NodeDefinition |
| VariableNode | instantiateNode() Инициализировать узел. |
Подробности
__construct(string|null $name, NodeParentInterface $parent = null)
Параметры
| string|null | $name | |
| NodeParentInterface | $parent |
$this setParent(NodeParentInterface $parent)
Устанавливает родительский узел.
Параметры
| NodeParentInterface | $parent |
Значение возврата
| $this |
$this info(string $info)
Устанавливает сообщение информации.
Параметры
| string | $info | Текст информации |
Значение возврата
| $this |
$this example(string|array $example)
Устанавливает пример конфигурации.
Параметры
| string|array | $example |
Значение возврата
| $this |
$this attribute(string $key, mixed $value)
Устанавливает атрибут узла.
Параметры
| string | $key | |
| mixed | $value |
Значение возврата
| $this |
NodeParentInterface|NodeBuilder|NodeDefinition|ArrayNodeDefinition|VariableNodeDefinition|null end()
Возвращает родительский узел.
Значение возврата
| NodeParentInterface|NodeBuilder|NodeDefinition|ArrayNodeDefinition|VariableNodeDefinition|null | Билдер родительского узла |
NodeInterface getNode(bool $forceRootNode = false)
Создаёт узел.
Параметры
| bool | $forceRootNode | Принудительно назначить этот узел корневым узлом |
Значение возврата
| NodeInterface |
$this defaultValue(mixed $value)
Устанавливает значение по умолчанию.
Параметры
| mixed | $value | Значение по умолчанию |
Значение возврата
| $this |
$this isRequired()
Устанавливает узел как обязательный.
Значение возврата
| $this |
$this setDeprecated(string $message = 'The child node "%node%" at path "%path%" is deprecated.')
Устанавливает узел как устаревший.
Вы можете использовать %node% и %path% в вашем сообщении, чтобы отобразить соответственно имя узла и его полный путь.
Параметры
| string | $message | Сообщение об устаревании |
Значение возврата
| $this |
$this treatNullLike(mixed $value)
Устанавливает эквивалентное значение, используемое, когда узел содержит null.
Параметры
| mixed | $value |
Значение возврата
| $this |
$this treatTrueLike(mixed $value)
Устанавливает эквивалентное значение, используемое, когда узел содержит true.
Параметры
| mixed | $value |
Значение возврата
| $this |
$this treatFalseLike(mixed $value)
Устанавливает эквивалентное значение, используемое, когда узел содержит false.
Параметры
| mixed | $value |
Значение возврата
| $this |
$this defaultNull()
Устанавливает null в качестве значения по умолчанию.
Значение возврата
| $this |
$this defaultTrue()
Устанавливает true в качестве значения по умолчанию.
Значение возврата
| $this |
$this defaultFalse()
Устанавливает false в качестве значения по умолчанию.
Значение возврата
| $this |
ExprBuilder beforeNormalization()
Устанавливает выражение, выполняемое перед нормализацией.
Значение возврата
| ExprBuilder |
$this cannotBeEmpty()
Запрещает пустое значение узла.
Значение возврата
| $this |
ExprBuilder validate()
Устанавливает выражение для проверки.
Выражение получает значение узла и должно вернуть его. Оно может изменить его. При некорректном узле должно быть выброшено исключение.
Значение возврата
| ExprBuilder |
$this cannotBeOverwritten(bool $deny = true)
Устанавливает, можно ли перезаписывать узел.
Параметры
| bool | $deny | Запретить или разрешить перезапись |
Значение возврата
| $this |
protected ValidationBuilder validation()
Получает билдер правил валидации.
Значение возврата
| ValidationBuilder |
protected MergeBuilder merge()
Получает билдер правил слияния.
Значение возврата
| MergeBuilder |
protected NormalizationBuilder normalization()
Получает билдер правил нормализации.
Значение возврата
| NormalizationBuilder |
protected NodeInterface createNode()
Создаёт и настраивает узел в соответствии с этим определением.
Значение возврата
| NodeInterface | $node Экземпляр узла |
Исключения
| InvalidDefinitionException | При некорректном определении |
$this setPathSeparator(string $separator)
Установить разделитель пути.
Параметры
| string | $separator |
Значение возврата
| $this |
protected VariableNode instantiateNode()
Создать узел.
Значение возврата
| VariableNode | Узел |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
https://api.symfony.com/4.1/Symfony/Component/Config/Definition/Builder/VariableNodeDefinition.html