(PHP 5 >= 5.2.0)
SimpleXMLElement::registerXPathNamespace — Crea un contexto prefijo/ns para la siguiente petición XPath
$prefix
, string $ns
)Crea un contexto de prefijo/ns para la siguiente petición XPath. En particular, ésto es útil si el proveedor del documento XML proporcionado altera los prefijos del namespace. registerXPathNamespace creará un prefijo para el namespace asociado, permitiendo el acceso a los nodos en ese namespace sin necesidad de cambiar el código a los nuevos prefijos dictados por el proveedor.
prefix
El prefijo del namespace a usar en la petición XPath para el namespace
dado en ns
.
ns
El namespace a usar para la petición XPath. Debe coincidir con un
namespace en uso por el documento XML o la petición XPath usando
prefix
no retornará ningún resultado.
Devuelve TRUE
en caso de éxito o FALSE
en caso de error.
Ejemplo #1 Estableciendo un prefijo para el namespace a usar en una petición XPath
<?php
$xml = <<<EOD
<book xmlns:chap="http://example.org/titulo-capitulo">
<title>My Book</title>
<chapter id="1">
<chap:titulo>Chapter 1</chap:titulo>
<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:titulo>Chapter 2</chap:titulo>
<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', 'http://example.org/titulo-capitulo');
$resultado = $sxe->xpath('//c:titulo');
foreach ($resultado as $titulo) {
echo $titulo . "\n";
}
?>
El resultado del ejemplo sería:
Chapter 1 Chapter 2
Notar como el documento XML mostrado en el ejemplo establece un namespace con un prefijo de chap. En el caso de que este documento (u otro como este) hubiera usado un prefijo de c, como este ha cambiado, la petición XPath no retornará los resultados adecuados y la petición requerirá modificación. Usando registerXPathNamespace evita futuras modificaciones de la petición incluso si el proveedor cambia el prefijo del namespace.