Class Xml

XML handling for CakePHP.

The methods in these classes enable the datasources that use XML to work.

Package: Cake\Utility
Copyright: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
License: MIT License
Location: Cake/Utility/Xml.php

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()source protected static

_createChild( array $data )

Helper to _fromArray(). It will create childs of arrays

Parameters

array $data
Array with informations to create childs

_fromArray()source protected static

_fromArray( DOMDocument $dom , DOMElement $node , array $data , string $format )

Recursive method to create childs from array

Parameters

DOMDocument $dom
Handler to DOMDocument
DOMElement $node
Handler to DOMElement (child)
array $data
$data Array of data to append to the $node.
string $format
Either 'attributes' or 'tags'. This determines where nested keys go.

Throws

XmlException

_loadXml()source protected static

_loadXml( string $input , array $options )

Parse 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|DOMDocument

Throws

XmlException

_toArray()source protected static

_toArray( SimpleXMLElement $xml , array $parentData , string $ns , array $namespaces )

Recursive method to toArray

Parameters

SimpleXMLElement $xml
SimpleXMLElement object
array $parentData
$parentData Parent array with data
string $ns
Namespace of current child
array $namespaces
List of namespaces in XML

build()source public static

build( string|array $input , array $options array() )

Initialize 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>', array('return' => 'domdocument'));

Building XML from a file path:

$xml = Xml::build('/path/to/an/xml/file.xml');

Building from a remote URL:

$xml = Xml::build('http://example.com/example.xml');

Building from an array:

$value = array(
        'tags' => array(
            'tag' => array(
                array(
                    'id' => '1',
                    'name' => 'defect'
                ),
                array(
                    'id' => '2',
                    'name' => 'enhancement'
            )
            )
        )
    );
$xml = Xml::build($value);

When building XML from an array ensure that there is only one top level element.

Options

  • return Can be 'simplexml' to return object of SimpleXMLElement or 'domdocument' to return DOMDocument.
  • loadEntities Defaults to false. Set to true to enable loading of <!ENTITY definitions. This is disabled by default for security reasons.
  • readFile Set to false to disable file reading. This is important to disable when putting user data into Xml::build(). If enabled local & remote files will be read if they exist. Defaults to true for backwards compatibility reasons.
  • If using array as input, you can pass options from Xml::fromArray.

Parameters

string|array $input
XML string, a path to a file, a URL or an array
array $options optional array()
The options to use

Returns

SimpleXMLElement|DOMDocument
SimpleXMLElement or DOMDocument

Throws

XmlException

fromArray()source public static

fromArray( array $input , array $options array() )

Transform an array into a SimpleXMLElement

Options

  • format If create childs ('tags') or attributes ('attributes').
  • pretty Returns formatted Xml when set to true. Defaults to false
  • version Version of XML document. Default is 1.0.
  • encoding Encoding of XML document. If null remove from XML header. Default is the some of application.
  • return If return object of SimpleXMLElement ('simplexml') or DOMDocument ('domdocument'). Default is SimpleXMLElement.

Using the following data:

$value = array(
   'root' => array(
       'tag' => array(
           '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 $input
Array with data
array $options optional array()
The options to use

Returns

SimpleXMLElement|DOMDocument
SimpleXMLElement or DOMDocument

Throws

XmlException

toArray()source public static

toArray( SimpleXMLElement|DOMDocument|DOMNode $obj )

Returns this XML structure as an array.

Parameters

SimpleXMLElement|DOMDocument|DOMNode $obj
SimpleXMLElement, DOMDocument or DOMNode instance

Returns

array
Array representation of the XML structure.

Throws

XmlException

© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
http://api.cakephp.org/2.8/class-Xml.html