XML_FastCreate - Example 1

Driver : Text

Package overview

PHP source file

Others examples

• Fast creation of valid XML contents :

  Simply use the method of the tag name :

  $x->span("hi")

  = <span>hi</span>

  This is an 'overload' mapping of xml() method :

  $x->xml("span", "hi")

  = <span>hi</span>

  You can add attributes on the 1st parameter :

  $x->span(array('class'=>'test'), "hi")

  = <span class="test">hi<span>

  You can add tags inside your tag :

  $x->span("XML",
    $x->i("Fast"),
    $x->b("Create")
  )

  = <span>XML<i>Fast</i><b>Create</b></span>

  Make empty tag or alone tag :

  $x->span('')

  = <span></span>

  $x->br()

  = <br />

  You can make multiples parts and gather them later :

  $body = $x->div( $x->p("hello") );
  $x->body($body);

  List of methods :

  $x->quote("a > b") To convert HTML special tags (if quote option is false)

  $x->noquote("&nbsp;") To not convert HTML special tags (if quote option is true)

  $x->comment( $x->p("hello") ) To make XML comments

  $x->cdata("alert(\"Let's Go !\");") To make CDATA section

  $x->getXML() To get the XML output

  $x->isValid() To control your XML with the DTD

  $x->toXML() To write and control XML

  $x->importXML() To convert XML text to XML driver format

  $x->exportXML() To convert XML driver format to XML text

• XML conform to the DTD option

  Choose your DTD tool :

  Use the internal tool( Require XML_DTD package )

  Or define an external program (like xmllint)

• Independant output data

  Choose the output driver to use :

  Text : return strings

  XML_Tree : return XML_Tree objects( Require XML_Tree package )

  Or make your own ! :-)

• XML Translation option

  You can define tags to translate :

  $x->news(
    $x->title("Title"),
    $x->desc("Description")
  )

  Replaced by :

  <div class="news">
    <h1><span>Title</span></h1>
    <p>Description</p>
  </div>

  Translate declaration is very easy :

  'translate' => array(
    'news' => array('<div class="news">', '</div>'),
    'title' => array('<h1><span>', '</span></h1>'),
    'desc' => array('<p>', '</p>'),
  )

  You can also use shortcuts :

  'news' => array('<div class="news">', '</div>')
  shortcut : 'news' => array()

  'desc' => array('<p>', '</p>')
  shortcut : 'desc' => array('p')

  Prefix tag by '_' to ignore translation :

  $x->title("Title")

  = <h1><span>Title</span></h1>

  $x->_title("Title")

  = <title>Title</title>

• Others options

  Auto-quote attributes and contents

  Attributes and contents are automatically quoted, but you can set option 'quote' to false and use $x->quote()

  Indentation option

  Set the 'indent' option to true to make XML indentation( Require XML_Beautifier package )

  Write your XML output into a file

  Set the the destination file in the 'file' option

  Driver output options

  Each driver has these basic options :

  'version' To set the xml version (default = '1.0')

  'encoding' To set the xml encoding (default = 'UTF-8')

  'standalone' To set the xml standalone (default = 'no')

  'doctype' To set the doctype (doctype constants exists)

  'quote' To quote attributes and contents (default = true)

  With Zend Optimizer, the overload system will crash !

  But you can replace overloading by a tags list(see Example 5)

• Convert your HTML easily to FastCreate syntax !

  The script can convert HTML file to FastCreate syntax

  Give the name of the HTML file and the output file

  Or just convert your HTML selection under your editor

  Select the HTML text, call the macro and your selected text will be rewrited to FastCreate syntax !