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 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