SimpleXMLElement::registerXPathNamespace
(PHP 5 >= 5.1.0, PHP 7, PHP 8)
SimpleXMLElement::registerXPathNamespace — Erzeugt einen Prefix/Namespace-Kontext für den nächsten XPath-Query
Beschreibung
$prefix, string $namespace): bool
Erzeugt einen Prefix/Namespace-Kontext für den nächsten XPath-Query. Dies
ist besonders hilfreich, wenn der Anbieter des übergebenen XML-Dokuments
die Namespace-Prefixe verändert hat.
registerXPathNamespace erzeugt einen Prefix für die
dazugehörigen Namespaces, die das Abfragen der Knoten in diesem Namespace
erlauben, ohne dass der Code verändert werden muss, um die vom Anbieter
diktierten neuen Prefixes zu erlauben.
Parameter-Liste
-
prefix -
Der Namespace-Prefix der im XPath-Query für den angegebenen Namespace verwendet werden soll.
namespace. -
namespace -
Der Namespace, der für den XPath-Query verwendet wird. Dies muss einem Namespace entsprechen, der im XML-Dokument oder im XPath-Query verwendet wird.
Rückgabewerte
Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.
Beispiele
Beispiel #1 Einen Namespace-Prefix zur Verwendung in einem XPath-Query setzen
<?php
$xml = <<<EOD
<book xmlns:chap="http://example.org/chapter-title">
<title>My Book</title>
<chapter id="1">
<chap:title>Chapter 1</chap:title>
<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:title>Chapter 2</chap:title>
<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/chapter-title');
$result = $sxe->xpath('//c:title');
foreach ($result as $title) {
echo $title . "\n";
}
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Chapter 1 Chapter 2
Beachten Sie wie das im Beispiel vorgestellte XML-Dokument die Namespaces
mit dem Prefix chap verwendet. Stellen Sie sich vor,
dass dieses Dokument (oder ein anderes dieser Art) in der Vergangenheit
den Prefix c für den selben Namespace verwendete. Seit
dieser Änderung gibt der XPath-Query keine gültigen Resultate mehr zurück
und der Query benötigt eine Überarbeitung. Die Verwendung von
registerXPathNamespace bewahrt Sie vor zukünftigen
Modifikationen des Querys, auch wenn der Anbieter die Namespace-Prefixes
verändert.
Siehe auch
- SimpleXMLElement::xpath() - Führt eine XPath-Anfrage auf XML-Daten aus
- SimpleXMLElement::getDocNamespaces() - Liefert die im Dokument deklarierten Namensräume
- SimpleXMLElement::getNamespaces() - Gibt die im Dokument verwendeten Namespaces zurück
