Obtém um objeto SimpleXMLElement a partir de um nó XML ou HTML

# simplexml_import_dom

(PHP 5, PHP 7, PHP 8)

simplexml_import_dom — Obtém um objeto `SimpleXMLElement` a partir de um nó XML ou HTML

### Descrição

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

Esta função recebe um nó de um documento DOM e o transforma em um nó SimpleXML. O novo objeto pode ser utilizado como um elemento SimpleXML nativo.

### Parâmetros

`node`

  Um nó DOM

`class_name`

  Pode-se utilizar o parâmetro opcional simplexml_import_dom() para retornar um objeto da classe especificada. A classe deve estender a classe SimpleXMLElement.

### Valor Retornado

Retorna um SimpleXMLElement ou `null` em caso de falha.

### Erros/Exceções

Lança um TypeError quando for passado um `node` que não seja XML ou HTML.

### Registro de Alterações

Versão | Descrição
--- | ---
8.4.0 | Adicionado suporte para Dom\Document.
8.4.0 | Esta função agora lança um TypeError ao invés de um ValueError quando for passado um `node` que não seja XML ou HTML.

### Exemplos

Exemplo #1 Importando um DOMDocument

    <?php
    $dom = new DOMDocument;
    $dom->loadXML('<books><book><title>blah</title></book></books>');
    if (!$dom) {
        echo 'Erro ao interpretar o documento';
        exit;
    }

    $s = simplexml_import_dom($dom);

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

O exemplo acima produzirá:

    blah

Exemplo #2 Importando um Dom\Document

    <?php
    $dom = Dom\XMLDocument::createFromString('<livros><livro><titulo>Blá</titulo></livro></livros>');

    $s = simplexml_import_dom($dom);

    echo $s->livro[0]->titulo;
    ?>

O exemplo acima produzirá:

    Blá

### Veja Também

- dom_import_simplexml() - Obtém um objeto DOMAttr ou DOMElement a partir de um objeto SimpleXMLElement
- Uso Básico de SimpleXML

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open