XSLT_SET_SAX_HANDLERS(3)						 1						  XSLT_SET_SAX_HANDLERS(3)

xslt_set_sax_handlers - Set the SAX handlers to be called when the XML document gets processed

SYNOPSIS

       void xslt_set_sax_handlers (resource  $processor, array	$handlers)

DESCRIPTION

       xslt_set_sax_handlers(3) registers the SAX $handlers for the document, given a XSLT $processor resource.

	Using xslt_set_sax_handlers(3) doesn't look very different than running a SAX parser like xml_parse(3) on the result of an xslt_process(3)
       transformation.

PARAMETERS

	      o $
		processor -The XSLT processor link identifier, created with xslt_create(3).

	      o $handlers
		-$handlers should be an array in the following format:

	      <?php

	      $handlers = array(

		"document" => array(
		  "start_doc",
		  "end_doc"),

		"element"  => array(
		  "start_element",
		  "end_element"),

		"namespace" => array(
		  "start_namespace",
		  "end_namespace"),

		"comment"   => "comment",

		"pi"	    => "pi",

		"character" => "characters"

	      );
	      ?>

	      Note

		      The given array does not need to contain all of the different sax handler elements (although it can), but it only  needs	to
		     conform to "handler" => "function" format described above.

	       Each of the individual SAX handler functions are in the format below:

		     o
			start_doc (resource  $processor)

		     o
			end_doc (resource  $processor)

		     o
			start_element (resource  $processor, string  $name, array  $attributes)

		     o
			end_element (resource  $processor, string  $name)

		     o
			start_namespace (resource  $processor, string  $prefix, string	$uri)

		     o
			end_namespace (resource  $processor, string  $prefix)

		     o
			comment (resource  $processor, string  $contents)

		     o
			pi (resource  $processor, string  $target, string  $contents)

		     o
			characters (resource  $processor, string  $contents)

RETURN VALUES

	No value is returned.

EXAMPLES

       Example #1

	      xslt_set_sax_handlers(3) Example

	      <?php
	      // From ohlesbeauxjours at yahoo dot fr
	      // Here's a simple example that applies strtoupper() on
	      // the content of every <auteur> tag and then displays the
	      // resulting XML tree:

	      $xml='<?xml version="1.0"?>
	      <books>
	       <book>
		<title>Mme Bovary</title>
		<author>Gustave Flaubert</author>
	       </book>
	       <book>
		<title>Mrs Dalloway</title>
		<author>Virginia Woolf</author>
	       </book>
	      </books>';

	      $xsl='<?xml version="1.0"?>
	      <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
	      <xsl:output method="html" encoding="ISO-8859-1" indent="no" omit-xml-declaration="yes"/>
	      <xsl:template match="/">
	       <xsl:for-each select="books/book">
		<livre>
		 <auteur><xsl:value-of select="author/text()"/></auteur>
		</livre>
	       </xsl:for-each>
	      </xsl:template>
	      </xsl:stylesheet>';

	      // Handlers :
	      function start_document()
	      {
		// start reading the document
	      }

	      function end_document()
	      {
		// end reading the document
	      }

	      function start_element($parser, $name, $attributes)
	      {
		global $result,$tag;
		$result .= "<". $name . ">";
		$tag = $name;
	      }

	      function end_element($parser, $name)
	      {
		global $result;
		$result .= "</" . $name . ">";
	      }

	      function characters($parser, $data)
	      {
		global $result,$tag;
		if ($tag == "auteur" ) {
		  $data = strtoupper($data);
		}
		$result .= $data;
	      }

	      // Transformation :
	      $xh = xslt_create();
	      $handlers = array("document" => array("start_document","end_document"),
		 "element" => array("start_element","end_element"),
		 "character" => "characters");

	      xslt_set_sax_handlers($xh, $handlers);
	      xslt_process($xh, 'arg:/_xml', 'arg:/_xsl', NULL, array("/_xml"=>$xml, "/_xsl"=>$xsl));
	      xslt_free($xh);
	      ?>

	You can also use xslt_set_object(3) if you want to implement your handlers in an object.

       Example #2

	      Object oriented handler

	      <?php
	      // This is the object oriented version of the previous example
	      class data_sax_handler {

		var $buffer, $tag, $attrs;

		var $_xh;

		function data_sax_handler($xml, $xsl)
		{
		    // our xslt resource
		    $this->_xh = xslt_create();

		    xslt_set_object($this->_xs, $this);

		    // configure sax handlers
		    $handlers = array(
		      "document" => array('start_document', 'end_document'),
		      "element" => array('start_element', 'end_element'),
		      "character" => 'characters'
		    );

		    xslt_set_sax_handlers($this->_xh, $handlers);

		    xslt_process($this->_xh, 'arg:/_xml', 'arg:/_xsl', NULL, array("/_xml"=>$xml, "/_xsl"=>$xsl));
		    xslt_free($this->_xh);

		}

		function start_document()
		{
		      // start reading the document
		}

		function end_document() {
		      // complete reading the document
		}

		function start_element($parser, $name, $attributes) {
		      $this->tag = $name;
		      $this->buffer .= "<" . $name . ">";
		      $this->attrs = $attributes;
		}

		function end_element($parser, $name)
		{
		      $this->tag = '';
		      $this->buffer .= "</" . $name . ">";
		}

		function characters($parser, $data)
		{
		  if ($this->tag == 'auteur') {
			$data = strtoupper($data);
		  }
		  $this->buffer .= $data;
		}

		function get_buffer() {
		  return $this->buffer;
		}

	      }

	      $exec = new data_sax_handler($xml, $xsl);

	      ?>

	       Both examples will output:

	      <livre>
		 <auteur>GUSTAVE FLAUBERT</auteur>
	      </livre>
	      <livre>
		 <auteur>VIRGINIA WOOLF</auteur>
	      </livre>

PHP Documentation Group 												  XSLT_SET_SAX_HANDLERS(3)