Php/docs/simplexmlelement.construct

• PHP Manual
• SimpleXMLElement
• Creates a new SimpleXMLElement object

SimpleXMLElement::__construct

(PHP 5, PHP 7)

SimpleXMLElement::__construct — Creates a new SimpleXMLElement object

Description

final public SimpleXMLElement::__construct ( string $data [, int $options = 0 [, bool $data_is_url = FALSE [, string $ns = "" [, bool $is_prefix = FALSE ]]]] )

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, which affect reading of XML documents. Options which affect the output of XML documents (e.g. LIBXML_NOEMPTYTAG) are silently ignored.

Note:

It may be necessary to pass LIBXML_PARSEHUGE to be able to process deeply nested XML or very large text nodes.

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

Namespace prefix or URI.

is_prefix

TRUE if ns is a prefix, FALSE if it's a URI; defaults to FALSE.

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 additionally throws an Exception if the XML data could not be parsed.

Tip Use libxml_use_internal_errors() to suppress all XML errors, and libxml_get_errors() to iterate over them afterwards.

Changelog

Version	Description
5.2.0	Added the ns and is_prefix parameters.
5.1.2	Added the options and data_is_url parameters.

Examples

Note:

Listed examples may include example.php, which refers to the XML string found in the first example of the basic usage guide.

Example #1 Create a SimpleXMLElement object

<?phpinclude 'example.php';$sxe = new SimpleXMLElement($xmlstr);echo $sxe->movie[0]->title;?>

The above example will output:

PHP: Behind the Parser

Example #2 Create a SimpleXMLElement object from a URL

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

See Also

• Basic SimpleXML usage
• simplexml_load_string() - Interprets a string of XML into an object
• simplexml_load_file() - Interprets an XML file into an object
• Dealing with XML errors
• libxml_use_internal_errors() - Disable libxml errors and allow user to fetch error information as needed