registerXPathNamespace()

SimpleXMLElement::saveXML()

SimpleXML é uma extensão PHP que fornece uma API simples e fácil de usar para trabalhar com documentos XML. O método SimpleXMLElement::saveXML() é uma das funções principais fornecidas pelo SimpleXML. Ele permite exportar um documento XML representado por um objeto SimpleXMLElement como uma string.

Entendendo o método SimpleXMLElement::saveXML()

O método SimpleXMLElement::saveXML() exporta um documento XML. A sintaxe para PHP moderno é a seguinte:

saveXML ( ?SimpleXMLElement $node = null, int $options = 0 ) : string|false

Aqui, $node é um parâmetro opcional que especifica um nó filho a ser exportado. Se omitido, o documento inteiro é exportado. $options aceita flags bitwise das constantes LIBXML_* (por exemplo, LIBXML_NOEMPTYTAG) para controlar a formatação e o comportamento de saída. O método retorna a string XML em caso de sucesso, ou false em caso de falha. (Nota: A sintaxe de parâmetro anulável ?SimpleXMLElement requer PHP 7.1 ou posterior.)

Exemplo de Uso

O exemplo a seguir demonstra a saída como string e o salvamento em arquivo, juntamente com tratamento básico de erros:

<?php

$xml = new SimpleXMLElement('<book><title>PHP Basics</title></book>');

// Return as a string
$xmlString = $xml->saveXML();
if ($xmlString !== false) {
    echo $xmlString;
}

// Save to a file
$xmlString = $xml->saveXML();
if ($xmlString !== false) {
    file_put_contents('output.xml', $xmlString);
    echo "XML saved successfully.";
} else {
    echo "Failed to save XML.";
}
?>

No exemplo acima, primeiro criamos um objeto SimpleXMLElement representando um documento XML com um elemento book contendo um filho title. Em seguida, chamamos saveXML() sem argumentos para recuperar o XML como uma string. Depois, passamos essa string para file_put_contents() para salvar o documento diretamente no disco. As verificações com if garantem que tratamos os possíveis retornos false de forma adequada. (Nota: Salvar em arquivo requer permissões de escrita no diretório de destino.)

Conclusão

O método SimpleXMLElement::saveXML() é uma ferramenta essencial para trabalhar com XML em PHP. Ele fornece uma maneira direta de exportar dados XML como uma string usando sintaxe orientada a objetos. Ao compreender seus parâmetros e valores de retorno, os desenvolvedores podem gerenciar documentos XML de forma confiável em suas aplicações.

Prática