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

Véase también

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug
＋add a note

User Contributed Notes

There are no user contributed notes for this page.