SimpleXMLElement::registerXPathNamespace

(PHP 5 >= 5.1.0, PHP 7)

SimpleXMLElement::registerXPathNamespace — Crea un contexto prefijo/ns para la siguiente petición XPath

Descripción

public SimpleXMLElement::registerXPathNamespace ( string $prefix , string $ns ) : bool

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 para tener en cuenta los nuevos prefijos dictados por el proveedor.

Parámetros

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.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Ejemplos

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.

Ver también