XML belge işlenirken çağrılacak SAX eylemcilerini belirtir

Açıklama

void xslt_set_sax_handlers ( resource $işlemci , array $eylemciler )

XSLT işlemci özkaynağı verilen belge için SAX eylemciler'ini belirtmek için kullanılır.

xslt_set_sax_handlers() kullanımı, bir xslt_process() dönüşüm sonucunun üzerinde xml_parse() gibi bir SAX çözümleyici çalıştırmaktan pek de farklı değildir.

Değiştirgeler

işlemci

xslt_create() tarafından oluşturulmuş bir XSLT işlemci özkaynağı.

eylemciler

Aşağıdaki biçemde bir dizi olmalıdır:


<?php

$handlers = array(

  "document" => array(
    "belge_başı",
    "belge_sonu"),

  "element"  => array(
    "eleman_başı",
    "eleman_sonu"),

  "namespace" => array(
    "isimalanı_başı",
    "isimalanı_sonu"),

  "comment"   => "açıklama",

  "pi"        => "işlem_komutu",

  "character" => "karakterler"

);
?>

Buradaki işlevler xslt_set_scheme_handlers() işlevinde açıklanan söz dizimine uygun olmalıdır.

Bilginize:
Belirtilen dizinin bütün elemanları içermesi gerekmez. Sadece, yukarıda bahsedildiği gibi her elemanın "eylem" => "işlev" biçemine uygun verilmiş olması gerekir.

SAX eylemci işlevleri şu söz dizimleri ile çağrılır::

belge_başı ( resource $işlemci )
belge_sonu ( resource $işlemci )
eleman_başı ( resource $işlemci , string $isim , array $öznitelikler )
eleman_sonu ( resource $işlemci , string $isim )
isimalanı_başı ( resource $işlemci , string $önek , string $uri )
isimalanı_sonu ( resource $işlemci , string $önek )
açıklama ( resource $işlemci , string $içerik )
işlem_komutu ( resource $işlemci , string $hedef , string $içerik )
karakterler ( resource $işlemci , string $içerik )

Dönen Değerler

Hiçbir değer dönmez.

Örnekler

Örnek 1 - xslt_set_sax_handlers() örneği


<?php
// ohlesbeauxjours at yahoo dot fr'den
// Burada her <author> etiketinin içeriğine strtoupper()
// uygulanmakta ve elde edilen XML ağacı gösterilmektedir:

$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>';

// Eylemciler :
function start_document()
{
  // belgeyi okumaya başla
}

function end_document()
{
  // belgeyi okumayı bitir
}

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;
}

// Dönüşüm:
$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);
?>

Eylemcilerinizi bir nesne içinde gerçeklemek isterseniz xslt_set_object()işlevini de kullanabilirsiniz.

Örnek 2 - Nesne yönelimli eylemci


<?php
// Bu örnek, önceki örneğin nesne yönelimlisidir
class data_sax_handler {

  var $buffer, $tag, $attrs;

  var $_xh;

  function data_sax_handler($xml, $xsl)
  {
      // xslt özkaynağımız
      $this->_xh = xslt_create();

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

      // sax eylemcileri yapılandıralım
      $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()
  {
        // belgeyi okumaya başla
  }

  function end_document() {
        // belgeyi okumayı bitir
  }

  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);

?>

Her iki örnek de şu çıktıyı üretir::

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