Registra una función PHP como una función XPath en un espacio de nombres

# DOMXPath::registerPhpFunctionNS

(PHP >= 8.4.0)

DOMXPath::registerPhpFunctionNS — Registra una función PHP como una función XPath en un espacio de nombres

### Descripción

public function DOMXPath::registerPhpFunctionNS(string `$namespaceURI`, string `$name`, callable `$callable`): void

Este método permite utilizar una función PHP como una función XPath con espacio de nombres dentro de expresiones XPath.

### Parámetros

`namespaceURI`
  La URI del espacio de nombres.
`name`
  La función local dentro del espacio de nombres.
`callable`
  La función PHP a llamar cuando la función XPath es llamada en la expresión XPath. Cuando una lista de nodos es pasada como argumento a la retrollamada, el argumento se convierte en un array que contiene los nodos DOM correspondientes.

### Errores/Excepciones

- Lanza una ValueError si el nombre de un callback no es válido.
- Levanta una excepción ValueError si `options` contiene una opción inválida.
- Levanta una excepción ValueError si `overrideEncoding` utiliza un codificado desconocido.
- Lanza una TypeError si un callback dado no es llamable.

### Valores devueltos

No se retorna ningún valor.

### Ejemplos

Ejemplo #1 Registra una función XPath en un espacio de nombres y la llama desde la expresión XPath

    <?php

    $xml = <<<EOB
    <books>
    <book>
     <title>PHP Basics</title>
     <author>Jim Smith</author>
     <author>Jane Smith</author>
    </book>
    <book>
     <title>PHP Secrets</title>
     <author>Jenny Smythe</author>
    </book>
    <book>
     <title>XML basics</title>
     <author>Joe Black</author>
    </book>
    </books>
    EOB;

    $doc = new DOMDocument();
    $doc->loadXML($xml);

    $xpath = new DOMXPath($doc);

    // Registra el espacio de nombres my: (obligatorio)
    $xpath->registerNamespace("my", "urn:my.ns");

    // Registra las funciones PHP
    $xpath->registerPhpFunctionNS(
        'urn:my.ns',
        'substring',
        fn (array $arg1, int $start, int $length) => substr($arg1[0]->textContent, $start, $length)
    );

    // Llamada a la función substr en el título del libro
    $nodes = $xpath->query('//book[my:substring(title, 0, 3) = "PHP"]');

    echo "Encontrados {$nodes->length} libros cuyo título comienza con 'PHP':\n";
    foreach ($nodes as $node) {
       $title  = $node->getElementsByTagName("title")->item(0)->nodeValue;
       $author = $node->getElementsByTagName("author")->item(0)->nodeValue;
       echo "$title por $author\n";
    }

    ?>

Resultado del ejemplo anterior es similar a:

    Encontrados 2 libros cuyo título comienza con 'PHP':
    PHP Basics por Jim Smith
    PHP Secrets por Jenny Smythe

### Ver también

- DOMXPath::registerNamespace() - Registra el espacio de nombres con el objeto DOMXPath
- DOMXPath::query() - Evalúa la expresión XPath dada
- DOMXPath::evaluate() - Evalúa una expresión XPath dada y devuelve un resultado tipado si es posible
- XSLTProcessor::registerPHPFunctions() - Activa el uso de PHP en las hojas de estilo XSLT
- XSLTProcessor::registerPHPFunctionNS() - Registra una función PHP como una función XSLT en un espacio de nombres

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open