KeyValue
in package
implements
Element
'KeyValue' parses out all child elements from a single node, and outputs a key=>value struct.
Attributes will be removed, and duplicate child elements are discarded. Complex values within the elements will be parsed by the 'standard' parser.
For example, KeyValue will parse:
<s:root xmlns:s="http://sabredav.org/ns"> <s:elem1>value1</s:elem1> <s:elem2>value2</s:elem2> <s:elem3 /> </s:root>
Into:
[ "{http://sabredav.org/ns}elem1" => "value1", "{http://sabredav.org/ns}elem2" => "value2", "{http://sabredav.org/ns}elem3" => null, ];
Tags
Interfaces, Classes and Traits
- Element
- This is the XML element interface.
Table of Contents
- $value : array<string|int, mixed>
- Value to serialize.
- __construct() : mixed
- Constructor.
- xmlDeserialize() : mixed
- The deserialize method is called during xml parsing.
- xmlSerialize() : mixed
- The xmlSerialize metod is called during xml writing.
Properties
$value
Value to serialize.
protected
array<string|int, mixed>
$value
Methods
__construct()
Constructor.
public
__construct([array<string|int, mixed> $value = [] ]) : mixed
Parameters
- $value : array<string|int, mixed> = []
Return values
mixed —xmlDeserialize()
The deserialize method is called during xml parsing.
public
static xmlDeserialize(Reader $reader) : mixed
This method is called staticly, this is because in theory this method may be used as a type of constructor, or factory method.
Often you want to return an instance of the current class, but you are free to return other data as well.
Important note 2: You are responsible for advancing the reader to the next element. Not doing anything will result in a never-ending loop.
If you just want to skip parsing for this element altogether, you can just call $reader->next();
$reader->parseInnerTree() will parse the entire sub-tree, and advance to the next element.
Parameters
- $reader : Reader
Return values
mixed —xmlSerialize()
The xmlSerialize metod is called during xml writing.
public
xmlSerialize(Writer $writer) : mixed
Use the $writer argument to write its own xml serialization.
An important note: do not create a parent element. Any element implementing XmlSerializble should only ever write what's considered its 'inner xml'.
The parent of the current element is responsible for writing a containing element.
This allows serializers to be re-used for different element names.
If you are opening new elements, you must also close them again.
Parameters
- $writer : Writer