DOMDocument::getElementsByTagNameNS

(PHP 5, PHP 7, PHP 8)

DOMDocument::getElementsByTagNameNS Búsqueda de todos los elementos con un nombre de etiqueta dado en un espacio de nombres especificado

Descripción

public DOMDocument::getElementsByTagNameNS(?string $namespace, string $localName): DOMNodeList

Devuelve un DOMNodeList de todos los elementos con un nombre local dado y una URI de espacio de nombres.

Parámetros

namespace

La URI del espacio de nombres de los elementos a buscar. El valor especial "*" representa todos los espacios de nombres. Pasar null representa el espacio de nombres vacío.

localName

El nombre local de los elementos a buscar. El valor especial "*" representa todos los nombres locales.

Valores devueltos

Un nuevo objeto DOMNodeList que contiene todos los elementos encontrados.

Historial de cambios

Versión Descripción
8.0.3 namespace ahora es nullable.

Ejemplos

Ejemplo #1 Recuperación de todos los elementos XInclude

<?php

$xml
= <<<EOD
<?xml version="1.0" ?>
<chapter xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Books of the other guy..</title>
<para>
<xi:include href="book.xml">
<xi:fallback>
<error>xinclude: book.xml not found</error>
</xi:fallback>
</xi:include>
<include>
This is another namespace
</include>
</para>
</chapter>
EOD;
$dom = new DOMDocument;

// load the XML string defined above
$dom->loadXML($xml);

foreach (
$dom->getElementsByTagNameNS('http://www.w3.org/2001/XInclude', '*') as $element) {
echo
'local name: ', $element->localName, ', prefix: ', $element->prefix, "\n";
}
?>

El resultado del ejemplo sería:

local name: include, prefix: xi
local name: fallback, prefix: xi

Ver también