domxml_open_file

(PHP 4 >= 4.2.1, PECL)

domxml_open_file -- Creates a DOM object from an XML file

Description

DomDocument domxml_open_file ( string filename [, int mode [, array &error]] )

The function parses the XML document in the given file.

Parameters

filename

The path to the XML file. The file is accessed in read-only mode.

mode

This optional parameter can be used to change the behavior of this function.

You can use one of the following constants for it: DOMXML_LOAD_PARSING (default), DOMXML_LOAD_VALIDATING or DOMXML_LOAD_RECOVERING. You can add to it also DOMXML_LOAD_DONT_KEEP_BLANKS, DOMXML_LOAD_SUBSTITUTE_ENTITIES and DOMXML_LOAD_COMPLETE_ATTRS by bitwise or.

error

If used, it will contain the error messages. error must be passed in by reference.

Return Values

Returns a DomDocument instance of the given file.

Examples

Example 1. Opening an XML document from a file
<?php if (!$dom = domxml_open_file("example.xml")) { echo "Error while parsing the document\n"; exit; } $root = $dom->document_element(); ?>

ChangeLog

Version	Description
4.3.0	The parameters `mode` and `error` were added.