| simplexml44 - PHP4 backport of PHP5 SimpleXML |
simplexml44 - PHP4 backport of PHP5 SimpleXML
simplexml44 is a PHP4 backport of the new PHP5 API called SimpleXML. It provides a simple access to XML files, optimzed for reading. It is possible to change CDATA nodes or attributes, but it is not possible to add or delete certain nodes of the internal DOM like tree. simplexml44 is written in pure PHP.
PHP >= 4.2.0
XML Parser Extension (Expat)
As the name says it is simple and easy to use simplexml44. You may refer to the PHP documentation to get an idea of SimpleXML as it is implemented with PHP5. Due to the nature of PHP4 simplexml44 is a little bit different, but usage of this package is straightforward too.
Here is an example XML file, its name is 'simple.xml':
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<root>
<node>
<child gender="m">Tom Foo</child>
<child gender="f">Tamara Bar</child>
</node>
</root>
And here is how to access this file:
<?php
require_once('class/IsterXmlSimpleXMLImpl.php');
// read and write a document
$impl = new IsterXmlSimpleXMLImpl;
$doc = $impl->load_file('simple.xml');
print $doc->asXML();
// output is the file as given above
// access a node's CDATA
print $doc->root->node->child[0]->CDATA();
print "\n";
// output is "Tom Foo"
// access attributes
$attr = $doc->root->node->child[1]->attributes();
print $attr['gender'];
print "\n";
// output is "f"
// access children
foreach( $doc->root->node->children() as $child ) {
print $child->CDATA();
print "\n";
}
// output is:
// Tom Foo
// Tamara Bar
// change or add CDATA
$doc->root->node->child[0]->setCDATA('Jane Foo');
print $doc->asXML();
// change or add attribute
$doc->root->node->child[0]->setAttribute('gender', 'f');
print $doc->asXML();
?>
Because it's not possible to use the PHP5 ArrayIterator interface with PHP4 there are some differences between this implementation and that of PHP5:
CDATA() and setCDATA()
instead.
You cannot access attributes directly with array syntax. Always use attributes()
to read and setAttribute() to write attributes.
Comments are ignored.
Last and least, this is not as fast as PHP5 SimpleXML--it's pure PHP4.
setCDATA()If you have a document like this:
<?xml version="1.0" ?>
<root>
<node>cdata<p/></node>
</root>
And you handle it like this:
$doc->root->node->setCDATA('foo bar');
The resulting document will be this:
<?xml version="1.0" ?>
<root>
<node>foo bar</node>
</root>
Note the missing </p> tag. This is intentionally a feature not a bug, but it may be subject to further discussion.
Take care on your character encoding. The parser expects UTF-8 XML files and will produce UTF-8 output as well. Currently there is no way to change this unless you decide to patch the sources (and the underlying expat parser restricts character sets to UTF-8, ISO-8859-1 and US-ASCII). As long as you are using only ASCII characters there is no difference between ISO-8859-1 and UTF-8 and you will notice no problems, but if you are using characters of the higher part of ISO-8859-1 the differences will come into effect.
As with any DOM based API this is a little memory expensive. If you reuse the
IsterXmlSimpleXMLImpl object to parse different files and create multiple
documents in a single script you should consider to unset() documents not
longer used.
If you access a node with SimpleXML syntax and you encounter a 'Fatal error: Call to a member function on a non-object' you may check if you have used the proper array index for this node. Sure, it is also a good idea to check each node if it is an object at all.
To generate a detailed documentation of the provided classes you may use phpdocumentor (http://www.phpdoc.org/).
fix: IsterXmlExpat::parse() buffer bug
fix: first element of a number of elements with equal name not in output when
calling IsterSimpleXMLElement::children()
fix: broken references in conjunction with nested arrays break
sometimes IsterSimpleXMLElement::asXML()
Make tests work with PHP 4.2.x.
First public release.
Enter ./test directory and write 'make test' at the command prompt to execute unit tests. This requires GNU make utility on your mashine. The php cli binary is expected at /usr/bin/php (change Makefile to meet your installation).
Ingo Schramm
| simplexml44 - PHP4 backport of PHP5 SimpleXML |