PrototypedArrayNode

class PrototypedArrayNode extends ArrayNode

Представляет прототипизированный узел Array в дереве конфигурации.

Методы

	__construct(string $name, NodeInterface $parent = null)	from BaseNode
	setAttribute($key, $value)	from BaseNode
	getAttribute($key, $default = null)	from BaseNode
	hasAttribute($key)	from BaseNode
	getAttributes()	from BaseNode
	setAttributes(array $attributes)	from BaseNode
	removeAttribute($key)	from BaseNode
	setInfo(string $info) Устанавливает сообщение информации.	from BaseNode
string	getInfo() Возвращает сообщение информации.	from BaseNode
	setExample(string\|array $example) Устанавливает пример конфигурации для данного узла.	from BaseNode
string\|array	getExample() Возвращает пример конфигурации для данного узла.	from BaseNode
	addEquivalentValue(mixed $originalValue, mixed $equivalentValue) Добавляет эквивалентное значение.	from BaseNode
	setRequired(bool $boolean) Устанавливает данный узел как обязательный.	from BaseNode
	setAllowOverwrite(bool $allow) Устанавливает, можно ли перезаписывать этот узел.	from BaseNode
	setNormalizationClosures(array $closures) Устанавливает замыкания, используемые для нормализации.	from BaseNode
	setFinalValidationClosures(array $closures) Устанавливает замыкания, используемые для окончательной валидации.	from BaseNode
bool	isRequired() Проверяет, является ли этот узел обязательным.	from BaseNode
string	getName() Возвращает имя этого узла.	from BaseNode
string	getPath() Возвращает путь этого узла.	from BaseNode
mixed	merge(mixed $leftSide, mixed $rightSide) Объединяет два значения вместе.	from BaseNode
mixed	normalize(mixed $value) Нормализует значение, применяя все замыкания нормализации.	from BaseNode
NodeInterface\|null	getParent() Возвращает родительский узел для этого узла.	from BaseNode
mixed	finalize(mixed $value) Окончательно обрабатывает значение, применяя все окончательные замыкания.	from BaseNode
	setNormalizeKeys($normalizeKeys)	from ArrayNode
array	getChildren() Возвращает потомков этого узла.	from ArrayNode
	setXmlRemappings(array $remappings) Устанавливает xml переименования, которые должны быть выполнены.	from ArrayNode
array	getXmlRemappings() Получает xml переименования, которые должны быть выполнены.	from ArrayNode
	setAddIfNotSet(bool $boolean) Устанавливает, нужно ли добавлять значения по умолчанию для этого массива, если они не определены ни в одном из файлов конфигурации.	from ArrayNode
	setAllowFalse(bool $allow) Устанавливает, разрешено ли значение false, указывающее, что массив должен быть удален.	from ArrayNode
	setAllowNewKeys(bool $allow) Устанавливает, могут ли быть определены новые ключи в последующих конфигурациях.	from ArrayNode
	setPerformDeepMerging(bool $boolean) Устанавливает, должно ли происходить глубокое слияние.	from ArrayNode
	setIgnoreExtraKeys(bool $boolean, bool $remove = true) Указывает, нужно ли просто игнорировать дополнительные ключи без исключения.	from ArrayNode
	setName(string $name) Устанавливает имя узла.	from ArrayNode
bool	hasDefaultValue() Проверяет, есть ли у узла значение по умолчанию.
mixed	getDefaultValue() Возвращает значение по умолчанию.
	addChild(NodeInterface $node) Отключает добавление конкретных дочерних узлов для прототипизированных узлов.
	setMinNumberOfElements(int $number) Устанавливает минимальное количество элементов, которое должен содержать узел, основанный на прототипе. По умолчанию это ноль, что означает отсутствие элементов.
	setKeyAttribute(string $attribute, bool $remove = true) Устанавливает атрибут, значение которого будет использоваться в качестве ключа.
string	getKeyAttribute() Возвращает имя атрибута, значение которого должно использоваться в качестве ключа.
	setDefaultValue(string $value) Устанавливает значение по умолчанию для этого узла.
	setAddChildrenIfNoneSet(int\|string\|array\|null $children = array('defaults')) Добавляет дочерние узлы по умолчанию, если они не установлены.
	setPrototype(PrototypeNodeInterface $node) Устанавливает узел-прототип.
PrototypeNodeInterface	getPrototype() Возвращает прототип.

Подробности

__construct(string $name, NodeInterface $parent = null)

Параметры

string	$name	Имя узла
NodeInterface	$parent	Родитель этого узла

Исключения

InvalidArgumentException

если имя содержит точку

setAttribute($key, $value)

Параметры

	$key
	$value

getAttribute($key, $default = null)

Параметры

	$key
	$default

hasAttribute($key)

Параметры

$key

getAttributes()

setAttributes(array $attributes)

Параметры

array

$attributes

removeAttribute($key)

Параметры

$key

setInfo(string $info)

Устанавливает сообщение информации.

Параметры

string

$info

string getInfo()

Возвращает сообщение информации.

Значение возврата

string

Текст сообщения информации

setExample(string|array $example)

Устанавливает пример конфигурации для этого узла.

Параметры

string|array

$example

string|array getExample()

Извлекает пример конфигурации для этого узла.

Значение возврата

string|array

Пример

addEquivalentValue(mixed $originalValue, mixed $equivalentValue)

Добавляет эквивалентное значение.

Параметры

mixed	$originalValue
mixed	$equivalentValue

setRequired(bool $boolean)

Установить этот узел как обязательный.

Параметры

bool

$boolean

Обязательный узел

setAllowOverwrite(bool $allow)

Устанавливает, можно ли перезаписать этот узел.

Параметры

bool

$allow

setNormalizationClosures(array $closures)

Устанавливает замыкания, используемые для нормализации.

Параметры

array

$closures

Массив замыканий, используемых для нормализации

setFinalValidationClosures(array $closures)

Устанавливает замыкания, используемые для окончательной проверки.

Параметры

array

$closures

Массив замыканий, используемых для окончательной проверки

bool isRequired()

Проверяет, является ли этот узел обязательным.

Значение возврата

bool	Если узел обязательный

string getName()

Возвращает имя этого узла.

Значение возврата

string

Имя узла

string getPath()

Возвращает путь этого узла.

Значение возврата

string

Путь узла

final mixed merge(mixed $leftSide, mixed $rightSide)

Объединяет два значения вместе.

Параметры

mixed	$leftSide
mixed	$rightSide

Значение возврата

mixed

Объединённые значения

Исключения

ForbiddenOverwriteException

final mixed normalize(mixed $value)

Нормализует значение, применяя все замыкания нормализации.

Параметры

mixed

$value

Значение для нормализации

Значение возврата

mixed

Нормализованное значение

NodeInterface|null getParent()

Возвращает родительский узел для этого узла.

Значение возврата

NodeInterface|null

final mixed finalize(mixed $value)

Окончательно обрабатывает значение, применяя все замыкания окончательной обработки.

Параметры

mixed

$value

Значение для окончательной обработки

Значение возврата

mixed

Обработанное значение

Исключения

Исключение
Исключение некорректной конфигурации

setNormalizeKeys($normalizeKeys)

Параметры

$normalizeKeys

array getChildren()

Возвращает дочерние узлы этого узла.

Значение возврата

array

Дочерние узлы

setXmlRemappings(array $remappings)

Устанавливает XML-преобразования, которые должны быть выполнены.

Параметры

array

$remappings

массив вида array(array(строка, строка))

array getXmlRemappings()

Получает XML-преобразования, которые должны быть выполнены.

Значение возврата

array

$remappings массив вида array(array(строка, строка))

setAddIfNotSet(bool $boolean)

Устанавливает, нужно ли добавлять значения по умолчанию для этого массива, если он не был определен ни в одном из файлов конфигурации.

Параметры

bool

$boolean

setAllowFalse(bool $allow)

Устанавливает, разрешено ли значение false, указывающее, что массив должен быть удален.

Параметры

bool

$allow

setAllowNewKeys(bool $allow)

Устанавливает, можно ли определить новые ключи в последующих конфигурациях.

Параметры

bool

$allow

setPerformDeepMerging(bool $boolean)

Устанавливает, нужно ли выполнять глубокое объединение.

Параметры

bool

$boolean

setIgnoreExtraKeys(bool $boolean, bool $remove = true)

Указывает, следует ли просто игнорировать дополнительные ключи без исключения.

Параметры

bool	$boolean	Разрешить дополнительные ключи
bool	$remove	Удалить дополнительные ключи

setName(string $name)

Устанавливает имя узла.

Параметры

string

$name

Имя узла

bool hasDefaultValue()

Проверяет, имеет ли узел значение по умолчанию.

Значение возврата

bool	Если узел имеет значение по умолчанию

mixed getDefaultValue()

Возвращает значение по умолчанию.

Значение по умолчанию может быть явным или получено из значения по умолчанию прототипа.

Значение возврата

mixed

Значение по умолчанию

addChild(NodeInterface $node)

Отключить добавление конкретных дочерних узлов для прототипированных узлов.

Параметры

NodeInterface

$node

Исключения

Исключение

setMinNumberOfElements(int $number)

Устанавливает минимальное количество элементов, которое должен содержать узел на основе прототипа. По умолчанию это ноль, что означает отсутствие элементов.

Параметры

int

$number

setKeyAttribute(string $attribute, bool $remove = true)

Устанавливает атрибут, значение которого будет использоваться в качестве ключа.

Это полезно, когда у вас есть индексированный массив, который должен быть ассоциативным массивом. Вы можете выбрать элемент из массива, который будет ключом данного элемента. Например, если "id" является "ключом", то:

array(
    array('id' => 'my_name', 'foo' => 'bar'),
);

становится

 array(
     'my_name' => array('foo' => 'bar'),
 );

Если вы хотите, чтобы "'id' => 'my_name'" всё ещё присутствовал в результирующем массиве, то вы можете установить второй аргумент этого метода в false.

Параметры

string	$attribute	Имя атрибута, значение которого будет использоваться в качестве ключа
bool	$remove	Удалить ли ключ