root/trunk/patXMLPretty/Engine/Automatic.php

<?php
/**
 * File containing the patXMLPretty_Engine_Automatic class.
 *
 * @package        patXMLPretty
 * @subpackage     Engine
 * @author        Sebastian 'The Argh' Mordziol <argh@php-tools.net>
 * @see         patXMLPretty_Engine_Automatic
 */

/**
 * Special parsing engine which automatically determines the
 * best parsing engine to use on the current system and delegates
 * parsing to that engine.
 *
 * @package        patXMLPretty
 * @subpackage     Engine
 * @author        Sebastian 'The Argh' Mordziol <argh@php-tools.net>
 * @version        0.1.0
 * @license        LGPL
 * @link        http://www.php-tools.net
 * @see         patXMLPretty_Engine
 */
class patXMLPretty_Engine_Automatic extends patXMLPretty_Engine
{
   /**
    * Stores the name of the engine
    *
    * @access    private
    * @var        string
    */
    var $name = 'Automatic';

   /**
    * Stores a reference to the selected parsing engine
    * once it has been loaded.
    *
    * @access    private
    * @var         patXMLPretty_Engine
    * @see        getEngine()
    */
    var $engine = null;

   /**
    * Determines the engine to use, loads it and retrieves the
    * elements collection from it.
    *
    * Note: any options you set for this engine are passed on
    * to the target engine, so you can use this feature to set
    * any options you want the target engine to use.
    *
    * @access    public
    * @param    string
    * @return    array|patError
    */
    function parse( $xmlSource )
    {
        $engine =& $this->getEngine();
        if( patErrorManager::isError( $engine ) ) {
            return $engine;
        }

        $result = $engine->parse( $xmlSource );
        return $result;
    }

   /**
    * Retrieves the engine object the automatic renderer
    * has selected depending on the available resources and
    * the current system.
    *
    * @access    public
    * @return    patXMLPretty_Engine|patError
    * @see
    */
    function &getEngine()
    {
        if( is_object( $this->engine ) ) {
            return $this->engine;
        }

        $engineType = 'Unserializer';
        if( substr( phpversion(), 0, 1 ) >= 5 ) {
            $engineType = 'DOM';
        }

        $engine =& $this->pretty->createEngine( $engineType, $this->options );
        if( patErrorManager::isError( $engine ) ) {
            return $engine;
        }

        $this->engine =& $engine;
        return $engine;
    }
}

?>