Last updated: Fri, 10 Oct 2008

SimpleXMLElement->__construct

(No version information available, might be only in CVS)

SimpleXMLElement->__construct — Creates a new SimpleXMLElement object

Description

SimpleXMLElement

__construct ( string $data [, int $options [, bool $data_is_url [, string $ns [, bool $is_prefix ]]]] )

Creates a new SimpleXMLElement object.

Parameters

data: A well-formed XML string or the path or URL to an XML document if data_is_url is TRUE.
options: Optionally used to specify additional Libxml parameters.
data_is_url: By default, data_is_url is FALSE. Use TRUE to specify that data is a path or URL to an XML document instead of string data.
ns
is_prefix

Return Values

Returns a SimpleXMLElement object representing data .

Errors/Exceptions

Produces an E_WARNING error message for each error found in the XML data and throws an exception if errors were detected.

Examples

Example #1 Create a SimpleXMLElement object


<?php

include 'example.php';

$sxe = new SimpleXMLElement($xmlstr);
echo $sxe->movie[0]->title;

?>

Example #2 Create a SimpleXMLElement object from a URL


<?php

$sxe = new SimpleXMLElement('http://example.org/document.xml', NULL, TRUE);
echo $sxe->asXML();

?>


A note about the undocumented parameters:



$ns (string): namespace prefix or URI

$is_prefix (bool): TRUE if $ns is a prefix, FALSE if it's a URI; defaults to FALSE



E.g.:



<?php

$xml_string = '<xml xmlns:foo='uuid:BDC6E3F0-6DA3-11d1-A2A3-00AA00C14882'>

<foo:bar>..................';



$a = new SimpleXMLElement($xml_string, NULL, FALSE, 'foo', TRUE);

$b = new SimpleXMLElement($xml_string, NULL, FALSE, 'uuid:BDC6E3F0-6DA3-11d1-A2A3-00AA00C14882', FALSE);

?>



However, I don't know exactly what these parameters are used for. They don't seem to be of much help when dealing with namespaces :-?

tudor at culise dot net
20-Nov-2007 11:35


This class is extendable, but it's too bad that its constructor cannot be overriden (PHP says it's a final method). Thus the class should be wrapped using the delegation principle rather that extended.

add a note

SimpleXMLElement->getDocNamespaces

SimpleXMLElement->children