Class Xml
XML handling for CakePHP.
The methods in these classes enable the datasources that use XML to work.
Method Summary
-
_createChild() protected static
Helper to _fromArray(). It will create childs of arrays
-
_fromArray() protected static
Recursive method to create childs from array
-
_loadXml() protected static
Parse the input data and create either a SimpleXmlElement object or a DOMDocument.
-
_toArray() protected static
Recursive method to toArray
-
build() public static
Initialize SimpleXMLElement or DOMDocument from a given XML string, file path, URL or array.
-
fromArray() public static
Transform an array into a SimpleXMLElement
-
toArray() public static
Returns this XML structure as an array.
Method Detail
_createChild() ¶ protected static
_createChild(array $data): voidHelper to _fromArray(). It will create childs of arrays
Parameters
-
array$data Array with informations to create childs
Returns
void_fromArray() ¶ protected static
_fromArray(DOMDocument $dom, DOMElement $node, array $data, string $format): voidRecursive method to create childs from array
Parameters
-
DOMDocument$dom Handler to DOMDocument
-
DOMElement$node Handler to DOMElement (child)
-
array$data Array of data to append to the $node.
-
string$format Either 'attributes' or 'tags'. This determines where nested keys go.
Returns
voidThrows
Cake\Utility\Exception\XmlException_loadXml() ¶ protected static
_loadXml(string $input, array $options): SimpleXmlElement|DOMDocumentParse the input data and create either a SimpleXmlElement object or a DOMDocument.
Parameters
-
string$input The input to load.
-
array$options The options to use. See Xml::build()
Returns
SimpleXmlElement|DOMDocumentThrows
Cake\Utility\Exception\XmlException_toArray() ¶ protected static
_toArray(SimpleXMLElement $xml, array $parentData, string $ns, array $namespaces): voidRecursive method to toArray
Parameters
-
SimpleXMLElement$xml SimpleXMLElement object
-
array$parentData Parent array with data
-
string$ns Namespace of current child
-
array$namespaces List of namespaces in XML
Returns
voidbuild() ¶ public static
build(string|array $input, string|array $options = []): SimpleXMLElement|DOMDocumentInitialize SimpleXMLElement or DOMDocument from a given XML string, file path, URL or array.
Usage:
Building XML from a string:
$xml = Xml::build('<example>text</example>');Building XML from string (output DOMDocument):
$xml = Xml::build('<example>text</example>', ['return' => 'domdocument']);Building XML from a file path:
$xml = Xml::build('/path/to/an/xml/file.xml');Building XML from a remote URL:
use Cake\Network\Http\Client;
$http = new Client();
$response = $http->get('http://example.com/example.xml');
$xml = Xml::build($response->body());Building from an array:
$value = [
'tags' => [
'tag' => [
[
'id' => '1',
'name' => 'defect'
],
[
'id' => '2',
'name' => 'enhancement'
]
]
]
];
$xml = Xml::build($value);When building XML from an array ensure that there is only one top level element.
Options
returnCan be 'simplexml' to return object of SimpleXMLElement or 'domdocument' to return DOMDocument.loadEntitiesDefaults to false. Set to true to enable loading of<!ENTITYdefinitions. This is disabled by default for security reasons.readFileSet to false to disable file reading. This is important to disable when putting user data into Xml::build(). If enabled local files will be read if they exist. Defaults to true for backwards compatibility reasons.- If using array as input, you can pass
optionsfrom Xml::fromArray.
Parameters
-
string|array$input XML string, a path to a file, a URL or an array
-
string|array$options optional The options to use
Returns
SimpleXMLElement|DOMDocumentThrows
Cake\Utility\Exception\XmlExceptionfromArray() ¶ public static
fromArray(array|Cake\Collection\Collection $input, string|array $options = []): SimpleXMLElement|DOMDocumentTransform an array into a SimpleXMLElement
Options
formatIf create childs ('tags') or attributes ('attributes').prettyReturns formatted Xml when set totrue. Defaults tofalseversionVersion of XML document. Default is 1.0.encodingEncoding of XML document. If null remove from XML header. Default is the some of application.returnIf return object of SimpleXMLElement ('simplexml') or DOMDocument ('domdocument'). Default is SimpleXMLElement.
Using the following data:
$value = [
'root' => [
'tag' => [
'id' => 1,
'value' => 'defect',
'@' => 'description'
]
]
];Calling Xml::fromArray($value, 'tags'); Will generate:
<root><tag><id>1</id><value>defect</value>description</tag></root>
And calling Xml::fromArray($value, 'attributes'); Will generate:
<root><tag id="1" value="defect">description</tag></root>
Parameters
-
array|Cake\Collection\Collection$input Array with data or a collection instance.
-
string|array$options optional The options to use or a string to use as format.
Returns
SimpleXMLElement|DOMDocumentThrows
Cake\Utility\Exception\XmlExceptiontoArray() ¶ public static
toArray(SimpleXMLElement|DOMDocument|DOMNode $obj): arrayReturns this XML structure as an array.
Parameters
-
SimpleXMLElement|DOMDocument|DOMNode$obj SimpleXMLElement, DOMDocument or DOMNode instance
Returns
arrayThrows
Cake\Utility\Exception\XmlException