SimpleXMLElement->registerXPathNamespace()
(PHP 5 >= 5.2.0)
SimpleXMLElement->registerXPathNamespace() — Cria um prefixo/namespace de contexto para a próxima consulta XPath
Descrição
Cria um prefixo/namespace de contexto para a próxima consulta XPath. Basicamente, esta função auxilia se o provedor do documentl XML altera os prefixos dos namespaces. registerXPathNamespace criará um prefixo para o namespace associado, fazendo com que se possa acessar os namespaces sem ser necessário modificar o código para entrar em conformidade com os novos prefixos ditados pelo provedor dos dados.
Parâmetros
- prefix
-
O prefixo do namespace utilizado na consulta XPath para o namespace dado em ns .
- ns
-
O namespace para ser utilizado na consulta XPath. Este parâmetro deve fechar com um namespace utilizado pelo documento XML ou a consulta XPath utilizando prefix não retornará nenhum resultado.
Valor Retornado
Retorna TRUE em caso de sucesso ou FALSE em falhas.
Exemplos
Example#1 Definindo um prefixo de namespace para ser usado em uma consulta XPath
<?php
$xml = <<<EOD
<book xmlns:chap="https://example.org/chapter-title">
<title>My Book</title>
<chapter id="1">
<chap:title>Chapter 1</chap:title>
<para>Donec velit. Nullam eget tellus vitae tortor gravida scelerisque.
In orci lorem, cursus imperdiet, ultricies non, hendrerit et, orci.
Nulla facilisi. Nullam velit nisl, laoreet id, condimentum ut,
ultricies id, mauris.</para>
</chapter>
<chapter id="2">
<chap:title>Chapter 2</chap:title>
<para>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Proin
gravida. Phasellus tincidunt massa vel urna. Proin adipiscing quam
vitae odio. Sed dictum. Ut tincidunt lorem ac lorem. Duis eros
tellus, pharetra id, faucibus eu, dapibus dictum, odio.</para>
</chapter>
</book>
EOD;
$sxe = new SimpleXMLElement($xml);
$sxe->registerXPathNamespace('c', 'https://example.org/chapter-title');
$result = $sxe->xpath('//c:title');
foreach ($result as $title) {
echo $title . "\n";
}
?>
Perceba como como o documento XML mostrado no exemplo define o namespace com o prefixo de chap. Imagine que este documento (ou outro semelhante) deveria ter utilizado o prefixo de c no passado para o mesmo namespace. Uma vez que ele foi alterado, a consulta XPath não irá mais retornar os resultados apropriados e a consulta exigirá modificações. Utilizando registerXPathNamespace evita modificações futuras na consulta, mesmo que o provedor altere o prefixo dos namespaces.