Interpreta um arquivo XML e o transforma em um objeto

# simplexml_load_file

(PHP 5, PHP 7, PHP 8)

simplexml_load_file — Interpreta um arquivo XML e o transforma em um objeto

### Descrição

function simplexml_load_file(
string `$filename`,
?string `$class_name` = `SimpleXMLElement::class`,
int `$options` = 0,
string `$namespace_or_prefix` = "",
bool `$is_prefix` = `false`
): SimpleXMLElement|false

Converte o documento XML bem-formado no arquivo indicado em um objeto.

### Parâmetros

`filename`

  Caminho para o arquivo XML

`class_name`

  É possível utilizar o parâmetro opcional simplexml_load_file() para retornar um objeto da classe especificada. Esta classe deve estender SimpleXMLElement.

`options`
  Bit a bit `OR` das constantes de opções da libxml.
`namespace_or_prefix`

  Prefixo ou URI do namespace.

`is_prefix`

  `true` se `namespace_or_prefix` for um prefixo, `false` se for URI; o padrão é `false`.

### Valor Retornado

Retorna um objeto (object) da classe SimpleXMLElement com propriedades contendo os dados do documento XML, ou `false` em caso de falha.

Aviso

Esta função pode retornar o valor booleano `false`, mas também pode retornar um valor não booleano que pode ser avaliado como `false`. Leia a seção sobre Booleanos para mais informações. Use o operador === para testar o valor retornado por esta função.

### Erros/Exceções

Produz uma mensagem de erro `E_WARNING` para cada erro encontrado nos dados XML.

Dica

Utilize a função libxml_use_internal_errors() para suprimir todos os erros XML e a função libxml_get_errors() para iterar sobre eles posteriormente.

### Exemplos

Exemplo #1 Interpreta um documento XML

    <?php
    // O arquivo examples/book.xml contém um documento XML com um elemento root
    // e ao menos um elemento /[root]/title.

    if (file_exists('examples/book.xml')) {
        $xml = simplexml_load_file('examples/book.xml');

        print_r($xml);
    } else {
        exit('Falha ao abrir examples/book.xml.');
    }
    ?>

Este script mostrará, em caso de sucesso:

    SimpleXMLElement Object
    (
      [book] => Array
      ...
    )

Nesse ponto já é possível utilizar `$xml->title` e quaisquer outros elementos.

### Veja Também

- simplexml_load_string() - Interpreta uma string XML e a transforma em um objeto
- SimpleXMLElement::__construct() - Cria um novo objeto SimpleXMLElement
- Lidando com erros XML
- libxml_use_internal_errors() - Desabilita erros da libxml e permite que o usuário obtenha informações de erro conforme necessário
- Uso Básico de SimpleXML
- libxml_set_streams_context() - Define o contexto de fluxos para o próximo carregamento ou escrita de documento libxml

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