initial revision

requires PHP 5

Author: Rob Richards

ext/xmlreader/CREDITS

@@ -0,0 +1,2 @@
+XMLReader
+Rob Richards

ext/xmlreader/EXPERIMENTAL

@@ -0,0 +1,4 @@
+this module is experimental,
+its functions may change their names 
+so do not rely to much on them 
+you have been warned!

ext/xmlreader/README

@@ -0,0 +1,5 @@
+XMLReader represents a reader that provides non-cached, 
+forward-only access to XML data. It is based upon the 
+xmlTextReader api from libxml
+
+This extension is designed to only work under PHP 5.

ext/xmlreader/TODO

@@ -0,0 +1,6 @@
+- Refactor internals once libxml 2.6.x is minimum requirement for PHP 5
+  use new api for creating the xmlTextReaderPtr
+
+- Add Custom Error Handling
+
+

ext/xmlreader/config.m4

@@ -0,0 +1,22 @@
+dnl
+dnl $Id$
+dnl
+
+PHP_ARG_WITH(xmlreader, for XMLReader support,
+[  --with-xmlreader        Include XMLReader support.])
+
+if test -z "$PHP_LIBXML_DIR"; then
+  PHP_ARG_WITH(libxml-dir, libxml2 install dir,
+  [  --with-libxml-dir=DIR     XMLReader: libxml2 install prefix], no, no)
+fi
+
+if test "$PHP_XMLREADER" != "no" && test "$PHP_LIBXML" != "no"; then
+
+  PHP_SETUP_LIBXML(XMLREADER_SHARED_LIBADD, [
+    AC_DEFINE(HAVE_XMLREADER,1,[ ])
+    PHP_NEW_EXTENSION(xmlreader, php_xmlreader.c, $ext_shared)
+    PHP_SUBST(XMLREADER_SHARED_LIBADD)
+  ], [
+    AC_MSG_ERROR([xml2-config not found. Please check your libxml2 installation.])
+  ])
+fi

ext/xmlreader/config.w32

@@ -0,0 +1,14 @@
+// $Id$
+// vim:ft=javascript
+
+ARG_WITH("xmlreader", "XMLReader support", "yes");
+
+if (PHP_XMLREADER == "yes" && PHP_LIBXML == "yes") {
+	EXTENSION("xmlreader", "php_xmlreader.c");
+	AC_DEFINE("HAVE_XMLREADER", 1, "XMLReader support");
+	if (!PHP_XMLREADER_SHARED) {
+		ADD_FLAG("CFLAGS_XMLREADER", "/D LIBXML_STATIC");
+	}
+	ADD_EXTENSION_DEP('xmlreader', 'libxml');
+}
+

ext/xmlreader/examples/xmlreader.xml

@@ -0,0 +1,10 @@
+<books>
+ <book num="1">
+  <title>The Grapes of Wrath</title>
+  <author>John Steinbeck</author>
+ </book>
+ <book num="2">
+  <title>The Pearl</title>
+  <author>John Steinbeck</author>
+ </book>
+</books>

ext/xmlreader/examples/xmlreader_file.php

@@ -0,0 +1,20 @@
+<?php
+$reader = new XMLReader();
+$reader->open('xmlreader.xml');
+while ($reader->read()) {
+	if ($reader->nodeType != XMLREADER_END_ELEMENT) {
+		print "Node Name: ".$reader->name."\n";
+		print "Node Value: ".$reader->value."\n";
+		print "Node Depth: ".$reader->depth."\n";
+		if ($reader->nodeType==XMLREADER_ELEMENT && $reader->hasAttributes) {
+			$attr = $reader->moveToFirstAttribute();
+			while ($attr) {
+				print "   Attribute Name: ".$reader->name."\n";
+				print "   Attribute Value: ".$reader->value."\n";
+				$attr = $reader->moveToNextAttribute();
+			}
+		}
+		print "\n";
+	}
+}
+?>

ext/xmlreader/examples/xmlreader_string.php

@@ -0,0 +1,31 @@
+<?php
+$xmlstring = '<books>
+ <book num="1">
+  <title>The Grapes of Wrath</title>
+  <author>John Steinbeck</author>
+ </book>
+ <book num="2">
+  <title>The Pearl</title>
+  <author>John Steinbeck</author>
+ </book>
+</books>';
+
+$reader = new XMLReader();
+$reader->XML($xmlstring);
+while ($reader->read()) {
+	if ($reader->nodeType != XMLREADER_END_ELEMENT) {
+		print "Node Name: ".$reader->name."\n";
+		print "Node Value: ".$reader->value."\n";
+		print "Node Depth: ".$reader->depth."\n";
+		if ($reader->nodeType==XMLREADER_ELEMENT && $reader->hasAttributes) {
+			$attr = $reader->moveToFirstAttribute();
+			while ($attr) {
+				print "   Attribute Name: ".$reader->name."\n";
+				print "   Attribute Value: ".$reader->value."\n";
+				$attr = $reader->moveToNextAttribute();
+			}
+		}
+		print "\n";
+	}
+}
+?>