xslt_set_sax_handlers

Set the SAX handlers to be called when the XML document gets processed (PHP 4 >= 4.0.6)
void xslt_set_sax_handlers ( resource processor, array handlers )

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

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

Parameters

processor

The XSLT processor link identifier, created with xslt_create().

handlers

handlers should be an array in the following format:

copy to clipboard

<?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"

);
?>

Where the functions follow the syntax described for the scheme handler functions.

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:

Return Values

No value is returned.

Examples

Example 2668. xslt_set_sax_handlers() Example

copy to clipboard

<?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() if you want to implement your handlers in an object.

Example 2669. Object oriented handler

copy to clipboard

<?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:

copy to clipboard

<livre>

   <auteur>GUSTAVE FLAUBERT</auteur>

</livre>

<livre>

   <auteur>VIRGINIA WOOLF</auteur>

</livre>

xslt_set_sax_handlers

Set the SAX handlers to be called when the XML document gets processed (PHP 4 >= 4.0.6) void xslt_set_sax_handlers ( resource processor, array handlers )

Parameters

Return Values

Examples

Example 2668. xslt_set_sax_handlers() Example

Example 2669. Object oriented handler

Change Language

Set the SAX handlers to be called when the XML document gets processed (PHP 4 >= 4.0.6)
void xslt_set_sax_handlers ( resource processor, array handlers )