array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.simplexml-load-file.php', 1 => 'simplexml_load_file', 2 => 'Interpreta um arquivo XML e o transforma em um objeto', ), 'up' => array ( 0 => 'ref.simplexml.php', 1 => 'Funções da SimpleXML', ), 'prev' => array ( 0 => 'function.simplexml-import-dom.php', 1 => 'simplexml_import_dom', ), 'next' => array ( 0 => 'function.simplexml-load-string.php', 1 => 'simplexml_load_string', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/simplexml/functions/simplexml-load-file.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

simplexml_load_file

(PHP 5, PHP 7, PHP 8)

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

Descrição

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