PHP/XML mit Xpath abfragen: Unterschied zwischen den Versionen

Aus Mikiwiki
< PHP
Zur Navigation springen Zur Suche springen
(New page: Die Integration der Abfragesprache Xpath ist in PHP5 Bestandteil der Bibliothek "xmllib2" und entsprechend leicht zu verwenden. == Xpath praktisch verwenden == Das folgende Beispiel ...)
 
Zeile 150: Zeile 150:


{| class=wikitable
{| class=wikitable
! Name !! Typ !! Beschreibung
! width=15% | Name !! Typ !! Beschreibung
|-
|-
| <tt>item(<i>index</i>)</tt> || Methode || Gibt das betreffende Element, adressiert durch den Index, als Objekt vom Typ "DomNode" zurück.
| <tt>item(<i>index</i>)</tt> || Methode || Gibt das betreffende Element, adressiert durch den Index, als Objekt vom Typ "DomNode" zurück.
Zeile 160: Zeile 160:


{| class=wikitable
{| class=wikitable
! Name !! Beschreibung
! width=15% | Name !! Beschreibung
|-
|-
| <tt>insertBefore</tt> || Fügt vor einem anderen Knoten ein.
| <tt>insertBefore</tt> || Fügt vor einem anderen Knoten ein.
Zeile 190: Zeile 190:


{| class=wikitable
{| class=wikitable
! Name !! Beschreibung
! width=15% | Name !! Beschreibung
|-
|-
| <tt>nodeName<br>tagName</tt> || Name des Elements, das durch den Knoten dargestellt wird.
| <tt>nodeName<br>tagName</tt> || Name des Elements, das durch den Knoten dargestellt wird.

Version vom 13. Januar 2009, 21:50 Uhr

Die Integration der Abfragesprache Xpath ist in PHP5 Bestandteil der Bibliothek "xmllib2" und entsprechend leicht zu verwenden.

Xpath praktisch verwenden

Das folgende Beispiel zeigt die Wirkung der Xpath-Achsenbezeichner. Zum Testen aller erdenklichen Kombinationen wird eine XML-Datei mit entsprechenden Achsen entworfen.

<?xml version="1.0" encoding="iso-8859-1" ?>
<!-- Name     XPathTest.xml -->
<a>
  <b></b>
  <c>
    <d></d>
    <e>
      <h></h>
      <i></i>
    </e>
    <f></f>
    <g></g>
  </c>
  <x></x>
  <y>
    <z></z>
  </y>
</a>

Das folgende Skript wendet darauf alle XPath-Achsenbezeichner an und gibt eine Tabelle mit den Knoten aus.

<?php
function PrintNodeList($nodes)
{
  print "{$nodes->length} Knoten: ";
  foreach ($nodes as $node) 
  { 
    print "&lt;" . strtoupper($node->tagName) . "&gt; "; 
    # echo var_export($node);
  } 
}

$dom = new DomDocument(); 
## Laden des XML-Dokuments.
$dom->load("data/XPathTest.xml"); 
## Aus dem geladenen Dokument wird eine XPath-Instanz erstellt, die
## dann abgefragt werden kann.
$xp  = new DomXPath($dom); 

## Das Array "$expressions" definiert alle Achsennamen, die danach mit
## "foreach" durchlaufen werden, um eine Tabelle mit den Reaktionen zu
## erstellen.
$expressions = array("self",
                     "child",
                     "parent",
                     "descendant",
                     "descendant-or-self",
                     "ancestor",
                     "ancestor-or-self",
                     "preceding",
                     "preceding-sibling",
                     "following",
                     "following-sibling");

echo "<table border=\"1\">\n";
echo "<tr>\n";
echo "<th colspan=\"2\">Element-Beziehungen, ausgehend von \"c\"</th>\n";
echo "</tr>\n";
foreach ($expressions as $expression)
{
  ## Die Abfrage wird auf Grundlage der Elemente vervollständigt. Hier
  ## wird als Ausgangsknoten das Element "<c>" benutzt und der ent-
  ## sprechende Ausdruck angehängt, was dann z. B. folgenden Ausdruck
  ## ergibt:   //c/child::*
  ## In XPath werden damit alle Kinder des Elements "<c>" abgefragt.
  $nodes = $xp->query("//c/$expression::*");
  echo "<tr>\n<td>$expression</td>\n";
  echo "<td>\n";
  PrintNodeList($nodes);
  echo "</td>\n</tr>\n";
}
echo "</table>\n";
?>
Element-Beziehungen, ausgehend von "c"
self 1 Knoten: <C>
child 4 Knoten: <D> <E> <F> <G>
parent 1 Knoten: <A>
descendant 6 Knoten: <D> <E> <H> <I> <F> <G>
descendant-or-self 7 Knoten: <C> <D> <E> <H> <I> <F> <G>
ancestor 1 Knoten: <A>
ancestor-or-self 2 Knoten: <A> <C>
preceding 1 Knoten: <B>
preceding-sibling 1 Knoten: <B>
following 3 Knoten: <X> <Y> <Z>
following-sibling 2 Knoten: <X> <Y>

DOM-Klassen und -Methoden im Zusammenhang mit Xpath

Wenn eine Xpath-Abfrage erfolgreich war, wird eine Liste aus Knoten zurückgegeben, dargestellt durch die Klasse "DOMNodeList". Diese Liste kann nun mit "foreach" verarbeitet oder ein bestimmter Knoten ausgewählt werden. Die folgende Tabelle zeigt die möglichen Methoden und Eigenschaften.

Name Typ Beschreibung
item(index) Methode Gibt das betreffende Element, adressiert durch den Index, als Objekt vom Typ "DomNode" zurück.
length Eigenschaft Gibt die Anzahl der Elemente in der Auflistung zurück.

Der eigentliche Zugriff erfolgt nun über "DomNode", wo folgende Methoden eingesetzt werden können.

Name Beschreibung
insertBefore Fügt vor einem anderen Knoten ein.
replaceChild Ersetzt ein Kindelement.
removeChild Entfernt ein Kindelement.
appendChild Hängt ein Kindelement an.
hasChildNodes Prüft, ob Kindelemente vorhanden sind.
isSameNode Vergleicht zwei Knoten auf Identität.
isDefaultNamespace Prüft, ob der Knoten im Standardnamensraum ist.
isEqualNode Vergleicht zwei Knoten auf Gleichheit.
cloneNode Kopiert (klont) einen Knoten.
isSupported Prüft, ob eine bestimmte Funktion von dieser DOM-Implementierung unterstützt wird.
lookupPrefix Ermittelt das Präfix des Elements (das ist der Alias eines gegebenenfalls genutzten Namensraums).
lookupNamespaceUri Ermittelt den Namensraum des Elements (das ist der vollständige URI).

Neben den Methoden stehen auch eine Reihe von Eigenschaften zur Verfügung, die den Umgang mit XML im Zusammenhang mit Xpath erleichtern.

Name Beschreibung
nodeName
tagName
Name des Elements, das durch den Knoten dargestellt wird.
nodeValue
textContent
Der Inhalt (Text) des Knotens. "textContent" entspricht nicht dem Standard.
nodeType Knotentyp. Hier kann eine der PHP/DOM#Konstanten Konstanten von DOM stehen.
parentNode Der Elternknoten vom Typ "DomNode".
childNodes Auflistung der Kindknoten vom Typ "DomNodeList".
firstChild Der erste Kindknoten vom Typ "DomNode".
lastChild Der letzte Kindknoten vom Typ "DomNode".
nextSibling Der nächste Geschwisterknoten vom Typ "DomNode".
Attributes Auflistung der Attribute.
ownerDocument Das "DomDocument"-Objekt, dem dieser Knoten entstammt.