Last updated: Fri, 18 Jul 2008

DOMDocument::load

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

DOMDocument::load — Load XML from a file

Description

mixed DOMDocument::load ( string $filename [, int $options ] )

Loads an XML document from a file.

Warning

Unix style paths with forward slashes can cause significant performance degradation on Windows systems; be sure to call realpath() in such a case.

Parameters

filename: The path to the XML document.
options: Bitwise OR of the libxml option constants.

Return Values

Returns TRUE on success or FALSE on failure. If called statically, returns a DOMDocument but also causes an E_STRICT warning.

Errors/Exceptions

If an empty string is passed as the filename or an empty file is named, a warning will be generated. This warning is not generated by libxml and cannot be handled using libxml's error handling functions.

Examples

Example #1 Creating a Document


<?php
$doc = new DOMDocument();
$doc->load('book.xml');
echo $doc->saveXML();
?>


BadGuy´s note may be confusing since what he depicts is no special property of the relevant method. PHP works always in and on a local file system which means that if you want to use resources from other systems or - what is, indeed, BadGuy´s problem - need resources that have been dealt with by other programs or processes, you have to state and manage that explicitly in your code. PHP is just a quite normal program in that.



BadGuy´s solution is using the "http wrapper" to get output from another process (see "wrappers" in the PHP manual). Doing this, the appropriate syntax for http calls has to be respected.

admin at tijnema dot tijnema dot info
02-Jun-2007 01:39


In reply to BadGuy [at] BadGuy [dot] nl



When the news.php file is located on the same server, like you said in the first example then http://my.beautiful-website.com/xmlsource/news.php wouldn't work, but you should use http://localhost/xmlsource/news.php or http://127.0.0.1/xmlsource/news.php

BadGuy [at] BadGuy [dot] nl
18-Jan-2007 05:50


Note that this method uses the local file system before doing anything remote. The 'disadvantage' would be that if you would do the following:

<?php

$xml = new DOMDocument;

$xml->load("xmlsource/news.php");

?>



This would not make the method read the actual output of the news.php file --presumably valid xml data--, but the file contents --obviously this would be php code. So this will return an error saying news.php is missing the xml declaration and maybe the xml start-tag



What would work is the following:



<?php

$xml = new DOMDocument;

$xml->load("http://my.beautiful-website.com/xmlsource/news.php");

?>



This will force a http request to be used to get this file instead of just locally reading it and the file just returning code

daevid at daevid dot com
19-Oct-2005 02:08


Suppose you wanted to dynamically load an array from an .XSD file. This method is your guy. just remember to use the actual xs: portion in xpaths and such.





All the other "load" methods will error out.





<?php


$attributes = array();


$xsdstring = "/htdocs/api/xsd/common.xsd";


$XSDDOC = new DOMDocument();


$XSDDOC->preserveWhiteSpace = false;


if ($XSDDOC->load($xsdstring))


{


    $xsdpath = new DOMXPath($XSDDOC);


    $attributeNodes = 


              $xsdpath->


              query('//xs:simpleType[@name="attributeType"]')


              ->item(0);


    foreach ($attributeNodes->childNodes as $attr) 


    {


        $attributes[ $attr->getAttribute('value') ] = $attr->getAttribute('name');


    }


    unset($xsdpath);


}


print_r($attributes);


?>

add a note

DOMDocument::loadHTML

DOMDocument::importNode