PHP Manual: simplexml_import

Description

function simplexml_import_dom(object $node, ?string $class_name = SimpleXMLElement::class): ?SimpleXMLElement

This function takes a node of a DOM document and makes it into a SimpleXML node. This new object can then be used as a native SimpleXML element.

Parameters

node: A DOM Element node
class_name: You may use this optional parameter so that simplexml_import_dom() will return an object of the specified class. That class must extend the SimpleXMLElement class.

Return Values

Returns a SimpleXMLElement or null on failure.

Errors/Exceptions

Throws a TypeError when passed a non-XML or non-HTML node.

Throws a TypeError if class_name is not SimpleXMLElement or a class derived from it.

Changelog

Version	Description
8.4.0	Added support for Dom\Document.
8.4.0	This function now throws a TypeError instead of a ValueError when passed a non-XML or non-HTML `node`.

Examples

Example #1 Importing a DOMDocument

<?php
$dom = new DOMDocument;
$dom->loadXML('<books><book><title>blah</title></book></books>');

$s = simplexml_import_dom($dom);

echo $s->book[0]->title;
?>

The above example will output:

blah

Example #2 Importing a Dom\Document

<?php
$dom = Dom\XMLDocument::createFromString('<books><book><title>blah</title></book></books>');

$s = simplexml_import_dom($dom);

echo $s->book[0]->title;
?>