This class is a abstraction class for the PHP Expat XML functions.

You can define handler functions/objects for start, end, PI and data sections (1.) or your can define path which will trigger the defined event when encountered (2.)

Example:

1.) $parser->setEvents(array("startElement"=> "myFunction",
                             "endElement"=> "myFunction",
                             "characterData"=> "myFunction",
                             "processingInstruction" => "myFunction");

The value can also be an array with the object reference and the method to call.
i.e. "startElement"=>array(&$myObj, "myMethod") instead of "startelement"=>"myFunction"

2.) $parser->setEvents(array("/root/foo/bar"=>"myFunction"));

Valid array keys are: 'startElement', 'endElement', 'characterData', 'processingInstruction' and paths
folowing the scheme '/root/element'. The path MUST begin from the root element and MUST start with '/'.

The value can also be an array with the object reference and the method to call.
i.e. "/foo/bar"=>array(&$myObj, "myMethod") instead of "/foo/bar"=>"myFunction"

It has 3 public methods:

setEventHandlers - Set specific handlers for the xml parser
parseFile        - Used to parse a XML file
parse             - Used to parse a XML string

A small example:

include("class.xmlparser.php");

// The XML String
$xml = '


    some text
    another text
';

function myHandler($name, $attribs, $content) {
    echo "HIT: [ $name ] [ $content ]
";
}

$parser = new XmlParser(); // Parser instance
$parser->setEventHandlers(array("/foo/bar"=>"myHandler")); // Define our handler
$parser->parse($xml); // Parse the XML string

Report bugs to: jan.lengowski@4fb.de