dwoo-project / dwoo

lib/Dwoo/Security/Policy.php

Indentation +271 added lines, -271 removed lines

@@ -25,298 +25,298 @@
  */
 class Policy
 {
-    /**
-     * Php handling constants, defaults to PHP_REMOVE
-     * PHP_ENCODE : run htmlentities over them
-     * PHP_REMOVE : remove all <?php ?> (+ short tags if your short tags option is on) from the input template
-     * PHP_ALLOW : leave them as they are
-     *
-     * @var int
-     */
-    const PHP_ENCODE = 1;
-    const PHP_REMOVE = 2;
-    const PHP_ALLOW  = 3;
+	/**
+	 * Php handling constants, defaults to PHP_REMOVE
+	 * PHP_ENCODE : run htmlentities over them
+	 * PHP_REMOVE : remove all <?php ?> (+ short tags if your short tags option is on) from the input template
+	 * PHP_ALLOW : leave them as they are
+	 *
+	 * @var int
+	 */
+	const PHP_ENCODE = 1;
+	const PHP_REMOVE = 2;
+	const PHP_ALLOW  = 3;
 
-    /**
-     * Constant handling constants, defaults to CONST_DISALLOW
-     * CONST_DISALLOW : throw an error if {$dwoo.const.*} is used in the template
-     * CONST_ALLOW : allow {$dwoo.const.*} calls
-     */
-    const CONST_DISALLOW = false;
-    const CONST_ALLOW    = true;
+	/**
+	 * Constant handling constants, defaults to CONST_DISALLOW
+	 * CONST_DISALLOW : throw an error if {$dwoo.const.*} is used in the template
+	 * CONST_ALLOW : allow {$dwoo.const.*} calls
+	 */
+	const CONST_DISALLOW = false;
+	const CONST_ALLOW    = true;
 
-    /**
-     * Php functions that are allowed to be used within the template.
-     *
-     * @var array
-     */
-    protected $allowedPhpFunctions = array(
-        'str_repeat'       => true,
-        'number_format'    => true,
-        'htmlentities'     => true,
-        'htmlspecialchars' => true,
-        'long2ip'          => true,
-        'strlen'           => true,
-        'list'             => true,
-        'empty'            => true,
-        'count'            => true,
-        'sizeof'           => true,
-        'in_array'         => true,
-        'is_array'         => true,
-    );
+	/**
+	 * Php functions that are allowed to be used within the template.
+	 *
+	 * @var array
+	 */
+	protected $allowedPhpFunctions = array(
+		'str_repeat'       => true,
+		'number_format'    => true,
+		'htmlentities'     => true,
+		'htmlspecialchars' => true,
+		'long2ip'          => true,
+		'strlen'           => true,
+		'list'             => true,
+		'empty'            => true,
+		'count'            => true,
+		'sizeof'           => true,
+		'in_array'         => true,
+		'is_array'         => true,
+	);
 
-    /**
-     * Methods that are allowed to be used within the template.
-     *
-     * @var array
-     */
-    protected $allowedMethods = array();
+	/**
+	 * Methods that are allowed to be used within the template.
+	 *
+	 * @var array
+	 */
+	protected $allowedMethods = array();
 
-    /**
-     * Paths that are safe to use with include or other file-access plugins.
-     *
-     * @var array
-     */
-    protected $allowedDirectories = array();
+	/**
+	 * Paths that are safe to use with include or other file-access plugins.
+	 *
+	 * @var array
+	 */
+	protected $allowedDirectories = array();
 
-    /**
-     * Stores the php handling level.
-     * defaults to self::PHP_REMOVE
-     *
-     * @var int
-     */
-    protected $phpHandling = self::PHP_REMOVE;
+	/**
+	 * Stores the php handling level.
+	 * defaults to self::PHP_REMOVE
+	 *
+	 * @var int
+	 */
+	protected $phpHandling = self::PHP_REMOVE;
 
-    /**
-     * Stores the constant handling level.
-     * defaults to self::CONST_DISALLOW
-     *
-     * @var bool
-     */
-    protected $constHandling = self::CONST_DISALLOW;
+	/**
+	 * Stores the constant handling level.
+	 * defaults to self::CONST_DISALLOW
+	 *
+	 * @var bool
+	 */
+	protected $constHandling = self::CONST_DISALLOW;
 
-    /**
-     * Adds a php function to the allowed list.
-     *
-     * @param mixed $func function name or array of function names
-     */
-    public function allowPhpFunction($func)
-    {
-        if (is_array($func)) {
-            foreach ($func as $fname) {
-                $this->allowedPhpFunctions[strtolower($fname)] = true;
-            }
-        } else {
-            $this->allowedPhpFunctions[strtolower($func)] = true;
-        }
-    }
+	/**
+	 * Adds a php function to the allowed list.
+	 *
+	 * @param mixed $func function name or array of function names
+	 */
+	public function allowPhpFunction($func)
+	{
+		if (is_array($func)) {
+			foreach ($func as $fname) {
+				$this->allowedPhpFunctions[strtolower($fname)] = true;
+			}
+		} else {
+			$this->allowedPhpFunctions[strtolower($func)] = true;
+		}
+	}
 
-    /**
-     * Removes a php function from the allowed list.
-     *
-     * @param mixed $func function name or array of function names
-     */
-    public function disallowPhpFunction($func)
-    {
-        if (is_array($func)) {
-            foreach ($func as $fname) {
-                unset($this->allowedPhpFunctions[strtolower($fname)]);
-            }
-        } else {
-            unset($this->allowedPhpFunctions[strtolower($func)]);
-        }
-    }
+	/**
+	 * Removes a php function from the allowed list.
+	 *
+	 * @param mixed $func function name or array of function names
+	 */
+	public function disallowPhpFunction($func)
+	{
+		if (is_array($func)) {
+			foreach ($func as $fname) {
+				unset($this->allowedPhpFunctions[strtolower($fname)]);
+			}
+		} else {
+			unset($this->allowedPhpFunctions[strtolower($func)]);
+		}
+	}
 
-    /**
-     * Returns the list of php functions allowed to run, note that the function names
-     * are stored in the array keys and not values.
-     *
-     * @return array
-     */
-    public function getAllowedPhpFunctions()
-    {
-        return $this->allowedPhpFunctions;
-    }
+	/**
+	 * Returns the list of php functions allowed to run, note that the function names
+	 * are stored in the array keys and not values.
+	 *
+	 * @return array
+	 */
+	public function getAllowedPhpFunctions()
+	{
+		return $this->allowedPhpFunctions;
+	}
 
-    /**
-     * Adds a class method to the allowed list, this must be used for
-     * both static and non static method by providing the class name
-     * and method name to use.
-     *
-     * @param mixed  $class  class name or array of array('class', 'method') couples
-     * @param string $method method name
-     */
-    public function allowMethod($class, $method = null)
-    {
-        if (is_array($class)) {
-            foreach ($class as $elem) {
-                $this->allowedMethods[strtolower($elem[0])][strtolower($elem[1])] = true;
-            }
-        } else {
-            $this->allowedMethods[strtolower($class)][strtolower($method)] = true;
-        }
-    }
+	/**
+	 * Adds a class method to the allowed list, this must be used for
+	 * both static and non static method by providing the class name
+	 * and method name to use.
+	 *
+	 * @param mixed  $class  class name or array of array('class', 'method') couples
+	 * @param string $method method name
+	 */
+	public function allowMethod($class, $method = null)
+	{
+		if (is_array($class)) {
+			foreach ($class as $elem) {
+				$this->allowedMethods[strtolower($elem[0])][strtolower($elem[1])] = true;
+			}
+		} else {
+			$this->allowedMethods[strtolower($class)][strtolower($method)] = true;
+		}
+	}
 
-    /**
-     * Removes a class method from the allowed list.
-     *
-     * @param mixed  $class  class name or array of array('class', 'method') couples
-     * @param string $method method name
-     */
-    public function disallowMethod($class, $method = null)
-    {
-        if (is_array($class)) {
-            foreach ($class as $elem) {
-                unset($this->allowedMethods[strtolower($elem[0])][strtolower($elem[1])]);
-            }
-        } else {
-            unset($this->allowedMethods[strtolower($class)][strtolower($method)]);
-        }
-    }
+	/**
+	 * Removes a class method from the allowed list.
+	 *
+	 * @param mixed  $class  class name or array of array('class', 'method') couples
+	 * @param string $method method name
+	 */
+	public function disallowMethod($class, $method = null)
+	{
+		if (is_array($class)) {
+			foreach ($class as $elem) {
+				unset($this->allowedMethods[strtolower($elem[0])][strtolower($elem[1])]);
+			}
+		} else {
+			unset($this->allowedMethods[strtolower($class)][strtolower($method)]);
+		}
+	}
 
-    /**
-     * Returns the list of class methods allowed to run, note that the class names
-     * and method names are stored in the array keys and not values.
-     *
-     * @return array
-     */
-    public function getAllowedMethods()
-    {
-        return $this->allowedMethods;
-    }
+	/**
+	 * Returns the list of class methods allowed to run, note that the class names
+	 * and method names are stored in the array keys and not values.
+	 *
+	 * @return array
+	 */
+	public function getAllowedMethods()
+	{
+		return $this->allowedMethods;
+	}
 
-    /**
-     * Adds a directory to the safelist for includes and other file-access plugins.
-     * note that all the includePath directories you provide to the Dwoo_Template_File class
-     * are automatically marked as safe
-     *
-     * @param mixed $path a path name or an array of paths
-     */
-    public function allowDirectory($path)
-    {
-        if (is_array($path)) {
-            foreach ($path as $dir) {
-                $this->allowedDirectories[realpath($dir)] = true;
-            }
-        } else {
-            $this->allowedDirectories[realpath($path)] = true;
-        }
-    }
+	/**
+	 * Adds a directory to the safelist for includes and other file-access plugins.
+	 * note that all the includePath directories you provide to the Dwoo_Template_File class
+	 * are automatically marked as safe
+	 *
+	 * @param mixed $path a path name or an array of paths
+	 */
+	public function allowDirectory($path)
+	{
+		if (is_array($path)) {
+			foreach ($path as $dir) {
+				$this->allowedDirectories[realpath($dir)] = true;
+			}
+		} else {
+			$this->allowedDirectories[realpath($path)] = true;
+		}
+	}
 
-    /**
-     * Removes a directory from the safe list.
-     *
-     * @param mixed $path a path name or an array of paths
-     */
-    public function disallowDirectory($path)
-    {
-        if (is_array($path)) {
-            foreach ($path as $dir) {
-                unset($this->allowedDirectories[realpath($dir)]);
-            }
-        } else {
-            unset($this->allowedDirectories[realpath($path)]);
-        }
-    }
+	/**
+	 * Removes a directory from the safe list.
+	 *
+	 * @param mixed $path a path name or an array of paths
+	 */
+	public function disallowDirectory($path)
+	{
+		if (is_array($path)) {
+			foreach ($path as $dir) {
+				unset($this->allowedDirectories[realpath($dir)]);
+			}
+		} else {
+			unset($this->allowedDirectories[realpath($path)]);
+		}
+	}
 
-    /**
-     * Returns the list of safe paths, note that the paths are stored in the array
-     * keys and not values.
-     *
-     * @return array
-     */
-    public function getAllowedDirectories()
-    {
-        return $this->allowedDirectories;
-    }
+	/**
+	 * Returns the list of safe paths, note that the paths are stored in the array
+	 * keys and not values.
+	 *
+	 * @return array
+	 */
+	public function getAllowedDirectories()
+	{
+		return $this->allowedDirectories;
+	}
 
-    /**
-     * Sets the php handling level, defaults to REMOVE.
-     *
-     * @param int $level one of the Dwoo_Security_Policy::PHP_* constants
-     */
-    public function setPhpHandling($level = self::PHP_REMOVE)
-    {
-        $this->phpHandling = $level;
-    }
+	/**
+	 * Sets the php handling level, defaults to REMOVE.
+	 *
+	 * @param int $level one of the Dwoo_Security_Policy::PHP_* constants
+	 */
+	public function setPhpHandling($level = self::PHP_REMOVE)
+	{
+		$this->phpHandling = $level;
+	}
 
-    /**
-     * Returns the php handling level.
-     *
-     * @return int the current level, one of the Dwoo_Security_Policy::PHP_* constants
-     */
-    public function getPhpHandling()
-    {
-        return $this->phpHandling;
-    }
+	/**
+	 * Returns the php handling level.
+	 *
+	 * @return int the current level, one of the Dwoo_Security_Policy::PHP_* constants
+	 */
+	public function getPhpHandling()
+	{
+		return $this->phpHandling;
+	}
 
-    /**
-     * Sets the constant handling level, defaults to CONST_DISALLOW.
-     *
-     * @param bool $level one of the Dwoo_Security_Policy::CONST_* constants
-     */
-    public function setConstantHandling($level = self::CONST_DISALLOW)
-    {
-        $this->constHandling = $level;
-    }
+	/**
+	 * Sets the constant handling level, defaults to CONST_DISALLOW.
+	 *
+	 * @param bool $level one of the Dwoo_Security_Policy::CONST_* constants
+	 */
+	public function setConstantHandling($level = self::CONST_DISALLOW)
+	{
+		$this->constHandling = $level;
+	}
 
-    /**
-     * Returns the constant handling level.
-     *
-     * @return bool the current level, one of the Dwoo_Security_Policy::CONST_* constants
-     */
-    public function getConstantHandling()
-    {
-        return $this->constHandling;
-    }
+	/**
+	 * Returns the constant handling level.
+	 *
+	 * @return bool the current level, one of the Dwoo_Security_Policy::CONST_* constants
+	 */
+	public function getConstantHandling()
+	{
+		return $this->constHandling;
+	}
 
-    /**
-     * This is used at run time to check whether method calls are allowed or not.
-     *
-     * @param Core   $dwoo   dwoo instance that calls this
-     * @param object $obj    any object on which the method must be called
-     * @param string $method lowercased method name
-     * @param array  $args   arguments array
-     *
-     * @return mixed result of method call or unll + E_USER_NOTICE if not allowed
-     */
-    public function callMethod(Core $dwoo, $obj, $method, $args)
-    {
-        foreach ($this->allowedMethods as $class => $methods) {
-            if (!isset($methods[$method])) {
-                continue;
-            }
-            if ($obj instanceof $class) {
-                return call_user_func_array(array($obj, $method), $args);
-            }
-        }
-        $dwoo->triggerError('The current security policy prevents you from calling ' . get_class($obj) . '::' . $method . '()');
+	/**
+	 * This is used at run time to check whether method calls are allowed or not.
+	 *
+	 * @param Core   $dwoo   dwoo instance that calls this
+	 * @param object $obj    any object on which the method must be called
+	 * @param string $method lowercased method name
+	 * @param array  $args   arguments array
+	 *
+	 * @return mixed result of method call or unll + E_USER_NOTICE if not allowed
+	 */
+	public function callMethod(Core $dwoo, $obj, $method, $args)
+	{
+		foreach ($this->allowedMethods as $class => $methods) {
+			if (!isset($methods[$method])) {
+				continue;
+			}
+			if ($obj instanceof $class) {
+				return call_user_func_array(array($obj, $method), $args);
+			}
+		}
+		$dwoo->triggerError('The current security policy prevents you from calling ' . get_class($obj) . '::' . $method . '()');
 
-        return null;
-    }
+		return null;
+	}
 
-    /**
-     * This is used at compile time to check whether static method calls are allowed or not.
-     *
-     * @param mixed  $class  lowercased class name or array('class', 'method') couple
-     * @param string $method lowercased method name
-     *
-     * @return bool
-     */
-    public function isMethodAllowed($class, $method = null)
-    {
-        if (is_array($class)) {
-            list($class, $method) = $class;
-        }
-        foreach ($this->allowedMethods as $allowedClass => $methods) {
-            if (!isset($methods[$method])) {
-                continue;
-            }
-            if ($class === $allowedClass || is_subclass_of($class, $allowedClass)) {
-                return true;
-            }
-        }
+	/**
+	 * This is used at compile time to check whether static method calls are allowed or not.
+	 *
+	 * @param mixed  $class  lowercased class name or array('class', 'method') couple
+	 * @param string $method lowercased method name
+	 *
+	 * @return bool
+	 */
+	public function isMethodAllowed($class, $method = null)
+	{
+		if (is_array($class)) {
+			list($class, $method) = $class;
+		}
+		foreach ($this->allowedMethods as $allowedClass => $methods) {
+			if (!isset($methods[$method])) {
+				continue;
+			}
+			if ($class === $allowedClass || is_subclass_of($class, $allowedClass)) {
+				return true;
+			}
+		}
 
-        return false;
-    }
+		return false;
+	}
 }

lib/Dwoo/Template/File.php

Indentation +248 added lines, -248 removed lines

@@ -29,279 +29,279 @@
  */
 class File extends String
 {
-    /**
-     * Template filename.
-     *
-     * @var string
-     */
-    protected $file;
+	/**
+	 * Template filename.
+	 *
+	 * @var string
+	 */
+	protected $file;
 
-    /**
-     * Include path(s) to look into to find this template.
-     *
-     * @var array
-     */
-    protected $includePath = null;
+	/**
+	 * Include path(s) to look into to find this template.
+	 *
+	 * @var array
+	 */
+	protected $includePath = null;
 
-    /**
-     * Resolved path cache when looking for a file in multiple include paths.
-     * this is reset when the include path is changed
-     *
-     * @var string
-     */
-    protected $resolvedPath = null;
+	/**
+	 * Resolved path cache when looking for a file in multiple include paths.
+	 * this is reset when the include path is changed
+	 *
+	 * @var string
+	 */
+	protected $resolvedPath = null;
 
-    /**
-     * Creates a template from a file.
-     *
-     * @param string $file        the path to the template file, make sure it exists
-     * @param int    $cacheTime   duration of the cache validity for this template,
-     *                            if null it defaults to the Dwoo instance that will
-     *                            render this template
-     * @param string $cacheId     the unique cache identifier of this page or anything else that
-     *                            makes this template's content unique, if null it defaults
-     *                            to the current url
-     * @param string $compileId   the unique compiled identifier, which is used to distinguish this
-     *                            template from others, if null it defaults to the filename+bits of the path
-     * @param mixed  $includePath a string for a single path to look into for the given file, or an array of paths
-     */
-    public function __construct($file, $cacheTime = null, $cacheId = null, $compileId = null, $includePath = null)
-    {
-        $this->file      = $file;
-        $this->name      = basename($file);
-        $this->cacheTime = $cacheTime;
+	/**
+	 * Creates a template from a file.
+	 *
+	 * @param string $file        the path to the template file, make sure it exists
+	 * @param int    $cacheTime   duration of the cache validity for this template,
+	 *                            if null it defaults to the Dwoo instance that will
+	 *                            render this template
+	 * @param string $cacheId     the unique cache identifier of this page or anything else that
+	 *                            makes this template's content unique, if null it defaults
+	 *                            to the current url
+	 * @param string $compileId   the unique compiled identifier, which is used to distinguish this
+	 *                            template from others, if null it defaults to the filename+bits of the path
+	 * @param mixed  $includePath a string for a single path to look into for the given file, or an array of paths
+	 */
+	public function __construct($file, $cacheTime = null, $cacheId = null, $compileId = null, $includePath = null)
+	{
+		$this->file      = $file;
+		$this->name      = basename($file);
+		$this->cacheTime = $cacheTime;
 
-        if ($compileId !== null) {
-            $this->compileId = str_replace('../', '__', strtr($compileId, '\\%?=!:;' . PATH_SEPARATOR, '/-------'));
-        }
+		if ($compileId !== null) {
+			$this->compileId = str_replace('../', '__', strtr($compileId, '\\%?=!:;' . PATH_SEPARATOR, '/-------'));
+		}
 
-        if ($cacheId !== null) {
-            $this->cacheId = str_replace('../', '__', strtr($cacheId, '\\%?=!:;' . PATH_SEPARATOR, '/-------'));
-        }
+		if ($cacheId !== null) {
+			$this->cacheId = str_replace('../', '__', strtr($cacheId, '\\%?=!:;' . PATH_SEPARATOR, '/-------'));
+		}
 
-        if (is_string($includePath)) {
-            $this->includePath = array($includePath);
-        } elseif (is_array($includePath)) {
-            $this->includePath = $includePath;
-        }
-    }
+		if (is_string($includePath)) {
+			$this->includePath = array($includePath);
+		} elseif (is_array($includePath)) {
+			$this->includePath = $includePath;
+		}
+	}
 
-    /**
-     * Sets the include path(s) to where the given template filename must be looked up.
-     *
-     * @param mixed $paths the path to look into, can be string for a single path or an array of paths
-     */
-    public function setIncludePath($paths)
-    {
-        if (is_array($paths) === false) {
-            $paths = array($paths);
-        }
+	/**
+	 * Sets the include path(s) to where the given template filename must be looked up.
+	 *
+	 * @param mixed $paths the path to look into, can be string for a single path or an array of paths
+	 */
+	public function setIncludePath($paths)
+	{
+		if (is_array($paths) === false) {
+			$paths = array($paths);
+		}
 
-        $this->includePath  = $paths;
-        $this->resolvedPath = null;
-    }
+		$this->includePath  = $paths;
+		$this->resolvedPath = null;
+	}
 
-    /**
-     * Return the current include path(s).
-     *
-     * @return array
-     */
-    public function getIncludePath()
-    {
-        return $this->includePath;
-    }
+	/**
+	 * Return the current include path(s).
+	 *
+	 * @return array
+	 */
+	public function getIncludePath()
+	{
+		return $this->includePath;
+	}
 
-    /**
-     * Checks if compiled file is valid (exists and it's the modification is greater or
-     * equal to the modification time of the template file).
-     *
-     * @param string file
-     *
-     * @return bool True cache file existance and it's modification time
-     */
-    protected function isValidCompiledFile($file)
-    {
-        return parent::isValidCompiledFile($file) && (int)$this->getUid() <= filemtime($file);
-    }
+	/**
+	 * Checks if compiled file is valid (exists and it's the modification is greater or
+	 * equal to the modification time of the template file).
+	 *
+	 * @param string file
+	 *
+	 * @return bool True cache file existance and it's modification time
+	 */
+	protected function isValidCompiledFile($file)
+	{
+		return parent::isValidCompiledFile($file) && (int)$this->getUid() <= filemtime($file);
+	}
 
-    /**
-     * Returns the template source of this template.
-     *
-     * @return string
-     */
-    public function getSource()
-    {
-        return file_get_contents($this->getResourceIdentifier());
-    }
+	/**
+	 * Returns the template source of this template.
+	 *
+	 * @return string
+	 */
+	public function getSource()
+	{
+		return file_get_contents($this->getResourceIdentifier());
+	}
 
-    /**
-     * Returns the resource name for this template class.
-     *
-     * @return string
-     */
-    public function getResourceName()
-    {
-        return 'file';
-    }
+	/**
+	 * Returns the resource name for this template class.
+	 *
+	 * @return string
+	 */
+	public function getResourceName()
+	{
+		return 'file';
+	}
 
-    /**
-     * Returns this template's source filename.
-     *
-     * @return string
-     * @throws DwooException
-     */
-    public function getResourceIdentifier()
-    {
-        if ($this->resolvedPath !== null) {
-            return $this->resolvedPath;
-        } elseif ($this->includePath === null) {
-            return $this->file;
-        } else {
-            foreach ($this->includePath as $path) {
-                $path = rtrim($path, DIRECTORY_SEPARATOR);
-                if (file_exists($path . DIRECTORY_SEPARATOR . $this->file) === true) {
-                    $this->resolvedPath = $path . DIRECTORY_SEPARATOR . $this->file;
+	/**
+	 * Returns this template's source filename.
+	 *
+	 * @return string
+	 * @throws DwooException
+	 */
+	public function getResourceIdentifier()
+	{
+		if ($this->resolvedPath !== null) {
+			return $this->resolvedPath;
+		} elseif ($this->includePath === null) {
+			return $this->file;
+		} else {
+			foreach ($this->includePath as $path) {
+				$path = rtrim($path, DIRECTORY_SEPARATOR);
+				if (file_exists($path . DIRECTORY_SEPARATOR . $this->file) === true) {
+					$this->resolvedPath = $path . DIRECTORY_SEPARATOR . $this->file;
 
-                    return $this->resolvedPath;
-                }
-            }
+					return $this->resolvedPath;
+				}
+			}
 
-            throw new DwooException('Template "' . $this->file . '" could not be found in any of your include path(s)');
-        }
-    }
+			throw new DwooException('Template "' . $this->file . '" could not be found in any of your include path(s)');
+		}
+	}
 
-    /**
-     * Returns an unique value identifying the current version of this template,
-     * in this case it's the unix timestamp of the last modification.
-     *
-     * @return string
-     */
-    public function getUid()
-    {
-        return (string)filemtime($this->getResourceIdentifier());
-    }
+	/**
+	 * Returns an unique value identifying the current version of this template,
+	 * in this case it's the unix timestamp of the last modification.
+	 *
+	 * @return string
+	 */
+	public function getUid()
+	{
+		return (string)filemtime($this->getResourceIdentifier());
+	}
 
-    /**
-     * Returns a new template object from the given include name, null if no include is
-     * possible (resource not found), or false if include is not permitted by this resource type.
-     *
-     * @param Core      $core           the dwoo instance requiring it
-     * @param mixed     $resourceId     the filename (relative to this template's dir) of the template to
-     *                                  include
-     * @param int       $cacheTime      duration of the cache validity for this template, if null it defaults
-     *                                  to the Dwoo instance that will render this template if null it
-     *                                  defaults to the Dwoo instance that will render this template if null
-     *                                  it defaults to the Dwoo instance that will render this template
-     * @param string    $cacheId        the unique cache identifier of this page or anything else that makes
-     *                                  this template's content unique, if null it defaults to the current
-     *                                  url makes this template's content unique, if null it defaults to the
-     *                                  current url makes this template's content unique, if null it defaults
-     *                                  to the current url
-     * @param string    $compileId      the unique compiled identifier, which is used to distinguish this
-     *                                  template from others, if null it defaults to the filename+bits of the
-     *                                  path template from others, if null it defaults to the filename+bits
-     *                                  of the path template from others, if null it defaults to the
-     *                                  filename+bits of the path
-     * @param ITemplate $parentTemplate the template that is requesting a new template object (through an
-     *                                  include, extends or any other plugin) an include, extends or any
-     *                                  other plugin) an include, extends or any other plugin)
-     *
-     * @return TemplateFile|null
-     * @throws DwooException
-     * @throws SecurityException
-     */
-    public static function templateFactory(Core $core, $resourceId, $cacheTime = null, $cacheId = null, $compileId = null, ITemplate $parentTemplate = null)
-    {
-        if (DIRECTORY_SEPARATOR === '\\') {
-            $resourceId = str_replace(
-                array("\t", "\n", "\r", "\f", "\v"), array(
-                '\\t',
-                '\\n',
-                '\\r',
-                '\\f',
-                '\\v'
-                ), $resourceId
-            );
-        }
-        $resourceId = strtr($resourceId, '\\', '/');
+	/**
+	 * Returns a new template object from the given include name, null if no include is
+	 * possible (resource not found), or false if include is not permitted by this resource type.
+	 *
+	 * @param Core      $core           the dwoo instance requiring it
+	 * @param mixed     $resourceId     the filename (relative to this template's dir) of the template to
+	 *                                  include
+	 * @param int       $cacheTime      duration of the cache validity for this template, if null it defaults
+	 *                                  to the Dwoo instance that will render this template if null it
+	 *                                  defaults to the Dwoo instance that will render this template if null
+	 *                                  it defaults to the Dwoo instance that will render this template
+	 * @param string    $cacheId        the unique cache identifier of this page or anything else that makes
+	 *                                  this template's content unique, if null it defaults to the current
+	 *                                  url makes this template's content unique, if null it defaults to the
+	 *                                  current url makes this template's content unique, if null it defaults
+	 *                                  to the current url
+	 * @param string    $compileId      the unique compiled identifier, which is used to distinguish this
+	 *                                  template from others, if null it defaults to the filename+bits of the
+	 *                                  path template from others, if null it defaults to the filename+bits
+	 *                                  of the path template from others, if null it defaults to the
+	 *                                  filename+bits of the path
+	 * @param ITemplate $parentTemplate the template that is requesting a new template object (through an
+	 *                                  include, extends or any other plugin) an include, extends or any
+	 *                                  other plugin) an include, extends or any other plugin)
+	 *
+	 * @return TemplateFile|null
+	 * @throws DwooException
+	 * @throws SecurityException
+	 */
+	public static function templateFactory(Core $core, $resourceId, $cacheTime = null, $cacheId = null, $compileId = null, ITemplate $parentTemplate = null)
+	{
+		if (DIRECTORY_SEPARATOR === '\\') {
+			$resourceId = str_replace(
+				array("\t", "\n", "\r", "\f", "\v"), array(
+				'\\t',
+				'\\n',
+				'\\r',
+				'\\f',
+				'\\v'
+				), $resourceId
+			);
+		}
+		$resourceId = strtr($resourceId, '\\', '/');
 
-        $includePath = null;
+		$includePath = null;
 
-        if (file_exists($resourceId) === false) {
-            if ($parentTemplate === null) {
-                $parentTemplate = $core->getTemplate();
-            }
-            if ($parentTemplate instanceof self) {
-                if ($includePath = $parentTemplate->getIncludePath()) {
-                    if (strstr($resourceId, '../')) {
-                        throw new DwooException('When using an include path you can not reference a template into a parent directory (using ../)');
-                    }
-                } else {
-                    $resourceId = dirname($parentTemplate->getResourceIdentifier()) . DIRECTORY_SEPARATOR . $resourceId;
-                    if (file_exists($resourceId) === false) {
-                        return null;
-                    }
-                }
-            } else {
-                return null;
-            }
-        }
+		if (file_exists($resourceId) === false) {
+			if ($parentTemplate === null) {
+				$parentTemplate = $core->getTemplate();
+			}
+			if ($parentTemplate instanceof self) {
+				if ($includePath = $parentTemplate->getIncludePath()) {
+					if (strstr($resourceId, '../')) {
+						throw new DwooException('When using an include path you can not reference a template into a parent directory (using ../)');
+					}
+				} else {
+					$resourceId = dirname($parentTemplate->getResourceIdentifier()) . DIRECTORY_SEPARATOR . $resourceId;
+					if (file_exists($resourceId) === false) {
+						return null;
+					}
+				}
+			} else {
+				return null;
+			}
+		}
 
-        if ($policy = $core->getSecurityPolicy()) {
-            while (true) {
-                if (preg_match('{^([a-z]+?)://}i', $resourceId)) {
-                    throw new SecurityException('The security policy prevents you to read files from external sources : <em>' . $resourceId . '</em>.');
-                }
+		if ($policy = $core->getSecurityPolicy()) {
+			while (true) {
+				if (preg_match('{^([a-z]+?)://}i', $resourceId)) {
+					throw new SecurityException('The security policy prevents you to read files from external sources : <em>' . $resourceId . '</em>.');
+				}
 
-                if ($includePath) {
-                    break;
-                }
+				if ($includePath) {
+					break;
+				}
 
-                $resourceId = realpath($resourceId);
-                $dirs       = $policy->getAllowedDirectories();
-                foreach ($dirs as $dir => $dummy) {
-                    if (strpos($resourceId, $dir) === 0) {
-                        break 2;
-                    }
-                }
-                throw new SecurityException('The security policy prevents you to read <em>' . $resourceId . '</em>');
-            }
-        }
+				$resourceId = realpath($resourceId);
+				$dirs       = $policy->getAllowedDirectories();
+				foreach ($dirs as $dir => $dummy) {
+					if (strpos($resourceId, $dir) === 0) {
+						break 2;
+					}
+				}
+				throw new SecurityException('The security policy prevents you to read <em>' . $resourceId . '</em>');
+			}
+		}
 
-        $class = 'Dwoo\Template\File';
-        if ($parentTemplate) {
-            $class = get_class($parentTemplate);
-        }
+		$class = 'Dwoo\Template\File';
+		if ($parentTemplate) {
+			$class = get_class($parentTemplate);
+		}
 
-        return new $class($resourceId, $cacheTime, $cacheId, $compileId, $includePath);
-    }
+		return new $class($resourceId, $cacheTime, $cacheId, $compileId, $includePath);
+	}
 
-    /**
-     * Returns the full compiled file name and assigns a default value to it if
-     * required.
-     *
-     * @param Core $core the dwoo instance that requests the file name
-     *
-     * @return string the full path to the compiled file
-     */
-    protected function getCompiledFilename(Core $core)
-    {
-        // no compile id was provided, set default
-        if ($this->compileId === null) {
-            $this->compileId = str_replace('../', '__', strtr($this->getResourceIdentifier(), '\\:', '/-'));
-        }
+	/**
+	 * Returns the full compiled file name and assigns a default value to it if
+	 * required.
+	 *
+	 * @param Core $core the dwoo instance that requests the file name
+	 *
+	 * @return string the full path to the compiled file
+	 */
+	protected function getCompiledFilename(Core $core)
+	{
+		// no compile id was provided, set default
+		if ($this->compileId === null) {
+			$this->compileId = str_replace('../', '__', strtr($this->getResourceIdentifier(), '\\:', '/-'));
+		}
 
-        return $this->compileId . '.d' . Core::RELEASE_TAG . '.php';
-    }
+		return $this->compileId . '.d' . Core::RELEASE_TAG . '.php';
+	}
 
-    /**
-     * Returns some php code that will check if this template has been modified or not.
-     * if the function returns null, the template will be instanciated and then the Uid checked
-     *
-     * @return string
-     */
-    public function getIsModifiedCode()
-    {
-        return '"' . $this->getUid() . '" == filemtime(' . var_export($this->getResourceIdentifier(), true) . ')';
-    }
+	/**
+	 * Returns some php code that will check if this template has been modified or not.
+	 * if the function returns null, the template will be instanciated and then the Uid checked
+	 *
+	 * @return string
+	 */
+	public function getIsModifiedCode()
+	{
+		return '"' . $this->getUid() . '" == filemtime(' . var_export($this->getResourceIdentifier(), true) . ')';
+	}
 }

lib/Dwoo/Template/String.php

Indentation +505 added lines, -505 removed lines

@@ -29,509 +29,509 @@
  */
 class String implements ITemplate
 {
-    /**
-     * Template name.
-     *
-     * @var string
-     */
-    protected $name;
-
-    /**
-     * Template compilation id.
-     *
-     * @var string
-     */
-    protected $compileId;
-
-    /**
-     * Template cache id, if not provided in the constructor, it is set to
-     * the md4 hash of the request_uri. it is however highly recommended to
-     * provide one that will fit your needs.
-     * in all cases, the compilation id is prepended to the cache id to separate
-     * templates with similar cache ids from one another
-     *
-     * @var string
-     */
-    protected $cacheId;
-
-    /**
-     * Validity duration of the generated cache file (in seconds).
-     * set to -1 for infinite cache, 0 to disable and null to inherit the Dwoo instance's cache time
-     *
-     * @var int
-     */
-    protected $cacheTime;
-
-    /**
-     * Boolean flag that defines whether the compilation should be enforced (once) or
-     * not use this if you have issues with the compiled templates not being updated
-     * but if you do need this it's most likely that you should file a bug report.
-     *
-     * @var bool
-     */
-    protected $compilationEnforced;
-
-    /**
-     * Caches the results of the file checks to save some time when the same
-     * templates is rendered several times.
-     *
-     * @var array
-     */
-    protected static $cache = array(
-        'cached'   => array(),
-        'compiled' => array()
-    );
-
-    /**
-     * Holds the compiler that built this template.
-     *
-     * @var ICompiler
-     */
-    protected $compiler;
-
-    /**
-     * Chmod value for all files written (cached or compiled ones).
-     * set to null if you don't want any chmod operation to happen
-     *
-     * @var int
-     */
-    protected $chmod = 0777;
-
-    /**
-     * Containing template string.
-     *
-     * @var string
-     */
-    protected $template;
-
-    /**
-     * Creates a template from a string.
-     *
-     * @param string $templateString the template to use
-     * @param int    $cacheTime      duration of the cache validity for this template,
-     *                               if null it defaults to the Dwoo instance that will
-     *                               render this template, set to -1 for infinite cache or 0 to disable
-     * @param string $cacheId        the unique cache identifier of this page or anything else that
-     *                               makes this template's content unique, if null it defaults
-     *                               to the current url
-     * @param string $compileId      the unique compiled identifier, which is used to distinguish this
-     *                               template from others, if null it defaults to the md4 hash of the template
-     */
-    public function __construct($templateString, $cacheTime = null, $cacheId = null, $compileId = null)
-    {
-        $this->template  = $templateString;
-        $this->name      = hash('md4', $templateString);
-        $this->cacheTime = $cacheTime;
-
-        if ($compileId !== null) {
-            $this->compileId = str_replace('../', '__', strtr($compileId, '\\%?=!:;' . PATH_SEPARATOR, '/-------'));
-        }
-
-        if ($cacheId !== null) {
-            $this->cacheId = str_replace('../', '__', strtr($cacheId, '\\%?=!:;' . PATH_SEPARATOR, '/-------'));
-        }
-    }
-
-    /**
-     * Returns the cache duration for this template.
-     * defaults to null if it was not provided
-     *
-     * @return int|null
-     */
-    public function getCacheTime()
-    {
-        return $this->cacheTime;
-    }
-
-    /**
-     * Sets the cache duration for this template.
-     * can be used to set it after the object is created if you did not provide
-     * it in the constructor
-     *
-     * @param int $seconds duration of the cache validity for this template, if
-     *                     null it defaults to the Dwoo instance's cache time. 0 = disable and
-     *                     -1 = infinite cache
-     */
-    public function setCacheTime($seconds = null)
-    {
-        $this->cacheTime = $seconds;
-    }
-
-    /**
-     * Returns the chmod value for all files written (cached or compiled ones).
-     * defaults to 0777
-     *
-     * @return int|null
-     */
-    public function getChmod()
-    {
-        return $this->chmod;
-    }
-
-    /**
-     * Set the chmod value for all files written (cached or compiled ones).
-     * set to null if you don't want to do any chmod() operation
-     *
-     * @param int $mask new bitmask to use for all files
-     */
-    public function setChmod($mask = null)
-    {
-        $this->chmod = $mask;
-    }
-
-    /**
-     * Returns the template name.
-     *
-     * @return string
-     */
-    public function getName()
-    {
-        return $this->name;
-    }
-
-    /**
-     * Returns the resource name for this template class.
-     *
-     * @return string
-     */
-    public function getResourceName()
-    {
-        return 'string';
-    }
-
-    /**
-     * Returns the resource identifier for this template, false here as strings don't have identifiers.
-     *
-     * @return false
-     */
-    public function getResourceIdentifier()
-    {
-        return false;
-    }
-
-    /**
-     * Returns the template source of this template.
-     *
-     * @return string
-     */
-    public function getSource()
-    {
-        return $this->template;
-    }
-
-    /**
-     * Returns an unique value identifying the current version of this template,
-     * in this case it's the md4 hash of the content.
-     *
-     * @return string
-     */
-    public function getUid()
-    {
-        return $this->name;
-    }
-
-    /**
-     * Returns the compiler used by this template, if it was just compiled, or null.
-     *
-     * @return ICompiler
-     */
-    public function getCompiler()
-    {
-        return $this->compiler;
-    }
-
-    /**
-     * Marks this template as compile-forced, which means it will be recompiled even if it
-     * was already saved and wasn't modified since the last compilation. do not use this in production,
-     * it's only meant to be used in development (and the development of dwoo particularly).
-     */
-    public function forceCompilation()
-    {
-        $this->compilationEnforced = true;
-    }
-
-    /**
-     * Returns the cached template output file name, true if it's cache-able but not cached
-     * or false if it's not cached.
-     *
-     * @param Core $core the dwoo instance that requests it
-     *
-     * @return string|bool
-     */
-    public function getCachedTemplate(Core $core)
-    {
-        if ($this->cacheTime !== null) {
-            $cacheLength = $this->cacheTime;
-        } else {
-            $cacheLength = $core->getCacheTime();
-        }
-
-        // file is not cacheable
-        if ($cacheLength == 0) {
-            return false;
-        }
-
-        $cachedFile = $this->getCacheFilename($core);
-
-        if (isset(self::$cache['cached'][$this->cacheId]) === true && file_exists($cachedFile)) {
-            // already checked, return cache file
-            return $cachedFile;
-        } elseif ($this->compilationEnforced !== true && file_exists($cachedFile) && ($cacheLength === - 1 || filemtime($cachedFile) > ($_SERVER['REQUEST_TIME'] - $cacheLength)) && $this->isValidCompiledFile($this->getCompiledFilename($core))) {
-            // cache is still valid and can be loaded
-            self::$cache['cached'][$this->cacheId] = true;
-
-            return $cachedFile;
-        } else {
-            // file is cacheable
-            return true;
-        }
-    }
-
-    /**
-     * Caches the provided output into the cache file.
-     *
-     * @param Core   $core   the dwoo instance that requests it
-     * @param string $output the template output
-     *
-     * @return mixed full path of the cached file or false upon failure
-     */
-    public function cache(Core $core, $output)
-    {
-        $cacheDir   = $core->getCacheDir();
-        $cachedFile = $this->getCacheFilename($core);
-
-        // the code below is courtesy of Rasmus Schultz,
-        // thanks for his help on avoiding concurency issues
-        $temp = tempnam($cacheDir, 'temp');
-        if (!($file = @fopen($temp, 'wb'))) {
-            $temp = $cacheDir . uniqid('temp');
-            if (!($file = @fopen($temp, 'wb'))) {
-                trigger_error('Error writing temporary file \'' . $temp . '\'', E_USER_WARNING);
-
-                return false;
-            }
-        }
-
-        fwrite($file, $output);
-        fclose($file);
-
-        $this->makeDirectory(dirname($cachedFile), $cacheDir);
-        if (!@rename($temp, $cachedFile)) {
-            @unlink($cachedFile);
-            @rename($temp, $cachedFile);
-        }
-
-        if ($this->chmod !== null) {
-            chmod($cachedFile, $this->chmod);
-        }
-
-        self::$cache['cached'][$this->cacheId] = true;
-
-        return $cachedFile;
-    }
-
-    /**
-     * Clears the cached template if it's older than the given time.
-     *
-     * @param Core $core      the dwoo instance that was used to cache that template
-     * @param int  $olderThan minimum time (in seconds) required for the cache to be cleared
-     *
-     * @return bool true if the cache was not present or if it was deleted, false if it remains there
-     */
-    public function clearCache(Core $core, $olderThan = - 1)
-    {
-        $cachedFile = $this->getCacheFilename($core);
-
-        return !file_exists($cachedFile) || (filectime($cachedFile) < (time() - $olderThan) && unlink($cachedFile));
-    }
-
-    /**
-     * Returns the compiled template file name.
-     *
-     * @param Core      $core     the dwoo instance that requests it
-     * @param ICompiler $compiler the compiler that must be used
-     *
-     * @return string
-     */
-    public function getCompiledTemplate(Core $core, ICompiler $compiler = null)
-    {
-        $compiledFile = $this->getCompiledFilename($core);
-
-        if ($this->compilationEnforced !== true && isset(self::$cache['compiled'][$this->compileId]) === true) {
-            // already checked, return compiled file
-        } elseif ($this->compilationEnforced !== true && $this->isValidCompiledFile($compiledFile)) {
-            // template is compiled
-            self::$cache['compiled'][$this->compileId] = true;
-        } else {
-            // compiles the template
-            $this->compilationEnforced = false;
-
-            if ($compiler === null) {
-                $compiler = $core->getDefaultCompilerFactory($this->getResourceName());
-
-                if ($compiler === null || $compiler === array('Dwoo\Compiler', 'compilerFactory')) {
-                    $compiler = Compiler::compilerFactory();
-                } else {
-                    $compiler = call_user_func($compiler);
-                }
-            }
-
-            $this->compiler = $compiler;
-
-            $compiler->setCustomPlugins($core->getCustomPlugins());
-            $compiler->setSecurityPolicy($core->getSecurityPolicy());
-            $this->makeDirectory(dirname($compiledFile), $core->getCompileDir());
-            file_put_contents($compiledFile, $compiler->compile($core, $this));
-            if ($this->chmod !== null) {
-                chmod($compiledFile, $this->chmod);
-            }
-
-            if (extension_loaded('Zend OPcache')) {
-                opcache_invalidate($compiledFile);
-            } elseif (extension_loaded('apc') && ini_get('apc.enabled')) {
-                apc_delete_file($compiledFile);
-            }
-
-            self::$cache['compiled'][$this->compileId] = true;
-        }
-
-        return $compiledFile;
-    }
-
-    /**
-     * Checks if compiled file is valid (it exists).
-     *
-     * @param string $file
-     *
-     * @return bool True cache file existance
-     */
-    protected function isValidCompiledFile($file)
-    {
-        return file_exists($file);
-    }
-
-    /**
-     * Returns a new template string object with the resource id being the template source code.
-     *
-     * @param Core      $core           the dwoo instance requiring it
-     * @param mixed     $resourceId     the filename (relative to this template's dir) of the template to include
-     * @param int       $cacheTime      duration of the cache validity for this template, if null it defaults to the
-     *                                  Dwoo instance that will render this template if null it defaults to the Dwoo
-     *                                  instance that will render this template
-     * @param string    $cacheId        the unique cache identifier of this page or anything else that makes this
-     *                                  template's content unique, if null it defaults to the current url makes this
-     *                                  template's content unique, if null it defaults to the current url
-     * @param string    $compileId      the unique compiled identifier, which is used to distinguish this template from
-     *                                  others, if null it defaults to the filename+bits of the path template from
-     *                                  others, if null it defaults to the filename+bits of the path
-     * @param ITemplate $parentTemplate the template that is requesting a new template object (through an include,
-     *                                  extends or any other plugin) an include, extends or any other plugin)
-     *
-     * @return $this
-     */
-    public static function templateFactory(Core $core, $resourceId, $cacheTime = null, $cacheId = null, $compileId = null, ITemplate $parentTemplate = null)
-    {
-        return new self($resourceId, $cacheTime, $cacheId, $compileId);
-    }
-
-    /**
-     * Returns the full compiled file name and assigns a default value to it if
-     * required.
-     *
-     * @param Core $core the dwoo instance that requests the file name
-     *
-     * @return string the full path to the compiled file
-     */
-    protected function getCompiledFilename(Core $core)
-    {
-        // no compile id was provided, set default
-        if ($this->compileId === null) {
-            $this->compileId = $this->name;
-        }
-
-        return $core->getCompileDir() . $this->compileId . '.d' . Core::RELEASE_TAG . '.php';
-    }
-
-    /**
-     * Returns the full cached file name and assigns a default value to it if
-     * required.
-     *
-     * @param Core $core the dwoo instance that requests the file name
-     *
-     * @return string the full path to the cached file
-     */
-    protected function getCacheFilename(Core $core)
-    {
-        // no cache id provided, use request_uri as default
-        if ($this->cacheId === null) {
-            if (isset($_SERVER['REQUEST_URI']) === true) {
-                $cacheId = $_SERVER['REQUEST_URI'];
-            } elseif (isset($_SERVER['SCRIPT_FILENAME']) && isset($_SERVER['argv'])) {
-                $cacheId = $_SERVER['SCRIPT_FILENAME'] . '-' . implode('-', $_SERVER['argv']);
-            } else {
-                $cacheId = '';
-            }
-            // force compiled id generation
-            $this->getCompiledFilename($core);
-
-            $this->cacheId = str_replace('../', '__', $this->compileId . strtr($cacheId, '\\%?=!:;' . PATH_SEPARATOR, '/-------'));
-        }
-
-        return $core->getCacheDir() . $this->cacheId . '.html';
-    }
-
-    /**
-     * Returns some php code that will check if this template has been modified or not.
-     * if the function returns null, the template will be instanciated and then the Uid checked
-     *
-     * @return string
-     */
-    public function getIsModifiedCode()
-    {
-        return null;
-    }
-
-    /**
-     * Ensures the given path exists.
-     *
-     * @param string $path    any path
-     * @param string $baseDir the base directory where the directory is created
-     *                        ($path must still contain the full path, $baseDir
-     *                        is only used for unix permissions)
-     *
-     * @throws Exception
-     */
-    protected function makeDirectory($path, $baseDir = null)
-    {
-        if (is_dir($path) === true) {
-            return;
-        }
-
-        if ($this->chmod === null) {
-            $chmod = 0777;
-        } else {
-            $chmod = $this->chmod;
-        }
-
-        $retries = 3;
-        while ($retries --) {
-            @mkdir($path, $chmod, true);
-            if (is_dir($path)) {
-                break;
-            }
-            usleep(20);
-        }
-
-        // enforce the correct mode for all directories created
-        if (strpos(PHP_OS, 'WIN') !== 0 && $baseDir !== null) {
-            $path    = strtr(str_replace($baseDir, '', $path), '\\', '/');
-            $folders = explode('/', trim($path, '/'));
-            foreach ($folders as $folder) {
-                $baseDir .= $folder . DIRECTORY_SEPARATOR;
-                if (!chmod($baseDir, $chmod)) {
-                    throw new Exception('Unable to chmod ' . "$baseDir to $chmod: " . print_r(error_get_last(), true));
-                }
-            }
-        }
-    }
+	/**
+	 * Template name.
+	 *
+	 * @var string
+	 */
+	protected $name;
+
+	/**
+	 * Template compilation id.
+	 *
+	 * @var string
+	 */
+	protected $compileId;
+
+	/**
+	 * Template cache id, if not provided in the constructor, it is set to
+	 * the md4 hash of the request_uri. it is however highly recommended to
+	 * provide one that will fit your needs.
+	 * in all cases, the compilation id is prepended to the cache id to separate
+	 * templates with similar cache ids from one another
+	 *
+	 * @var string
+	 */
+	protected $cacheId;
+
+	/**
+	 * Validity duration of the generated cache file (in seconds).
+	 * set to -1 for infinite cache, 0 to disable and null to inherit the Dwoo instance's cache time
+	 *
+	 * @var int
+	 */
+	protected $cacheTime;
+
+	/**
+	 * Boolean flag that defines whether the compilation should be enforced (once) or
+	 * not use this if you have issues with the compiled templates not being updated
+	 * but if you do need this it's most likely that you should file a bug report.
+	 *
+	 * @var bool
+	 */
+	protected $compilationEnforced;
+
+	/**
+	 * Caches the results of the file checks to save some time when the same
+	 * templates is rendered several times.
+	 *
+	 * @var array
+	 */
+	protected static $cache = array(
+		'cached'   => array(),
+		'compiled' => array()
+	);
+
+	/**
+	 * Holds the compiler that built this template.
+	 *
+	 * @var ICompiler
+	 */
+	protected $compiler;
+
+	/**
+	 * Chmod value for all files written (cached or compiled ones).
+	 * set to null if you don't want any chmod operation to happen
+	 *
+	 * @var int
+	 */
+	protected $chmod = 0777;
+
+	/**
+	 * Containing template string.
+	 *
+	 * @var string
+	 */
+	protected $template;
+
+	/**
+	 * Creates a template from a string.
+	 *
+	 * @param string $templateString the template to use
+	 * @param int    $cacheTime      duration of the cache validity for this template,
+	 *                               if null it defaults to the Dwoo instance that will
+	 *                               render this template, set to -1 for infinite cache or 0 to disable
+	 * @param string $cacheId        the unique cache identifier of this page or anything else that
+	 *                               makes this template's content unique, if null it defaults
+	 *                               to the current url
+	 * @param string $compileId      the unique compiled identifier, which is used to distinguish this
+	 *                               template from others, if null it defaults to the md4 hash of the template
+	 */
+	public function __construct($templateString, $cacheTime = null, $cacheId = null, $compileId = null)
+	{
+		$this->template  = $templateString;
+		$this->name      = hash('md4', $templateString);
+		$this->cacheTime = $cacheTime;
+
+		if ($compileId !== null) {
+			$this->compileId = str_replace('../', '__', strtr($compileId, '\\%?=!:;' . PATH_SEPARATOR, '/-------'));
+		}
+
+		if ($cacheId !== null) {
+			$this->cacheId = str_replace('../', '__', strtr($cacheId, '\\%?=!:;' . PATH_SEPARATOR, '/-------'));
+		}
+	}
+
+	/**
+	 * Returns the cache duration for this template.
+	 * defaults to null if it was not provided
+	 *
+	 * @return int|null
+	 */
+	public function getCacheTime()
+	{
+		return $this->cacheTime;
+	}
+
+	/**
+	 * Sets the cache duration for this template.
+	 * can be used to set it after the object is created if you did not provide
+	 * it in the constructor
+	 *
+	 * @param int $seconds duration of the cache validity for this template, if
+	 *                     null it defaults to the Dwoo instance's cache time. 0 = disable and
+	 *                     -1 = infinite cache
+	 */
+	public function setCacheTime($seconds = null)
+	{
+		$this->cacheTime = $seconds;
+	}
+
+	/**
+	 * Returns the chmod value for all files written (cached or compiled ones).
+	 * defaults to 0777
+	 *
+	 * @return int|null
+	 */
+	public function getChmod()
+	{
+		return $this->chmod;
+	}
+
+	/**
+	 * Set the chmod value for all files written (cached or compiled ones).
+	 * set to null if you don't want to do any chmod() operation
+	 *
+	 * @param int $mask new bitmask to use for all files
+	 */
+	public function setChmod($mask = null)
+	{
+		$this->chmod = $mask;
+	}
+
+	/**
+	 * Returns the template name.
+	 *
+	 * @return string
+	 */
+	public function getName()
+	{
+		return $this->name;
+	}
+
+	/**
+	 * Returns the resource name for this template class.
+	 *
+	 * @return string
+	 */
+	public function getResourceName()
+	{
+		return 'string';
+	}
+
+	/**
+	 * Returns the resource identifier for this template, false here as strings don't have identifiers.
+	 *
+	 * @return false
+	 */
+	public function getResourceIdentifier()
+	{
+		return false;
+	}
+
+	/**
+	 * Returns the template source of this template.
+	 *
+	 * @return string
+	 */
+	public function getSource()
+	{
+		return $this->template;
+	}
+
+	/**
+	 * Returns an unique value identifying the current version of this template,
+	 * in this case it's the md4 hash of the content.
+	 *
+	 * @return string
+	 */
+	public function getUid()
+	{
+		return $this->name;
+	}
+
+	/**
+	 * Returns the compiler used by this template, if it was just compiled, or null.
+	 *
+	 * @return ICompiler
+	 */
+	public function getCompiler()
+	{
+		return $this->compiler;
+	}
+
+	/**
+	 * Marks this template as compile-forced, which means it will be recompiled even if it
+	 * was already saved and wasn't modified since the last compilation. do not use this in production,
+	 * it's only meant to be used in development (and the development of dwoo particularly).
+	 */
+	public function forceCompilation()
+	{
+		$this->compilationEnforced = true;
+	}
+
+	/**
+	 * Returns the cached template output file name, true if it's cache-able but not cached
+	 * or false if it's not cached.
+	 *
+	 * @param Core $core the dwoo instance that requests it
+	 *
+	 * @return string|bool
+	 */
+	public function getCachedTemplate(Core $core)
+	{
+		if ($this->cacheTime !== null) {
+			$cacheLength = $this->cacheTime;
+		} else {
+			$cacheLength = $core->getCacheTime();
+		}
+
+		// file is not cacheable
+		if ($cacheLength == 0) {
+			return false;
+		}
+
+		$cachedFile = $this->getCacheFilename($core);
+
+		if (isset(self::$cache['cached'][$this->cacheId]) === true && file_exists($cachedFile)) {
+			// already checked, return cache file
+			return $cachedFile;
+		} elseif ($this->compilationEnforced !== true && file_exists($cachedFile) && ($cacheLength === - 1 || filemtime($cachedFile) > ($_SERVER['REQUEST_TIME'] - $cacheLength)) && $this->isValidCompiledFile($this->getCompiledFilename($core))) {
+			// cache is still valid and can be loaded
+			self::$cache['cached'][$this->cacheId] = true;
+
+			return $cachedFile;
+		} else {
+			// file is cacheable
+			return true;
+		}
+	}
+
+	/**
+	 * Caches the provided output into the cache file.
+	 *
+	 * @param Core   $core   the dwoo instance that requests it
+	 * @param string $output the template output
+	 *
+	 * @return mixed full path of the cached file or false upon failure
+	 */
+	public function cache(Core $core, $output)
+	{
+		$cacheDir   = $core->getCacheDir();
+		$cachedFile = $this->getCacheFilename($core);
+
+		// the code below is courtesy of Rasmus Schultz,
+		// thanks for his help on avoiding concurency issues
+		$temp = tempnam($cacheDir, 'temp');
+		if (!($file = @fopen($temp, 'wb'))) {
+			$temp = $cacheDir . uniqid('temp');
+			if (!($file = @fopen($temp, 'wb'))) {
+				trigger_error('Error writing temporary file \'' . $temp . '\'', E_USER_WARNING);
+
+				return false;
+			}
+		}
+
+		fwrite($file, $output);
+		fclose($file);
+
+		$this->makeDirectory(dirname($cachedFile), $cacheDir);
+		if (!@rename($temp, $cachedFile)) {
+			@unlink($cachedFile);
+			@rename($temp, $cachedFile);
+		}
+
+		if ($this->chmod !== null) {
+			chmod($cachedFile, $this->chmod);
+		}
+
+		self::$cache['cached'][$this->cacheId] = true;
+
+		return $cachedFile;
+	}
+
+	/**
+	 * Clears the cached template if it's older than the given time.
+	 *
+	 * @param Core $core      the dwoo instance that was used to cache that template
+	 * @param int  $olderThan minimum time (in seconds) required for the cache to be cleared
+	 *
+	 * @return bool true if the cache was not present or if it was deleted, false if it remains there
+	 */
+	public function clearCache(Core $core, $olderThan = - 1)
+	{
+		$cachedFile = $this->getCacheFilename($core);
+
+		return !file_exists($cachedFile) || (filectime($cachedFile) < (time() - $olderThan) && unlink($cachedFile));
+	}
+
+	/**
+	 * Returns the compiled template file name.
+	 *
+	 * @param Core      $core     the dwoo instance that requests it
+	 * @param ICompiler $compiler the compiler that must be used
+	 *
+	 * @return string
+	 */
+	public function getCompiledTemplate(Core $core, ICompiler $compiler = null)
+	{
+		$compiledFile = $this->getCompiledFilename($core);
+
+		if ($this->compilationEnforced !== true && isset(self::$cache['compiled'][$this->compileId]) === true) {
+			// already checked, return compiled file
+		} elseif ($this->compilationEnforced !== true && $this->isValidCompiledFile($compiledFile)) {
+			// template is compiled
+			self::$cache['compiled'][$this->compileId] = true;
+		} else {
+			// compiles the template
+			$this->compilationEnforced = false;
+
+			if ($compiler === null) {
+				$compiler = $core->getDefaultCompilerFactory($this->getResourceName());
+
+				if ($compiler === null || $compiler === array('Dwoo\Compiler', 'compilerFactory')) {
+					$compiler = Compiler::compilerFactory();
+				} else {
+					$compiler = call_user_func($compiler);
+				}
+			}
+
+			$this->compiler = $compiler;
+
+			$compiler->setCustomPlugins($core->getCustomPlugins());
+			$compiler->setSecurityPolicy($core->getSecurityPolicy());
+			$this->makeDirectory(dirname($compiledFile), $core->getCompileDir());
+			file_put_contents($compiledFile, $compiler->compile($core, $this));
+			if ($this->chmod !== null) {
+				chmod($compiledFile, $this->chmod);
+			}
+
+			if (extension_loaded('Zend OPcache')) {
+				opcache_invalidate($compiledFile);
+			} elseif (extension_loaded('apc') && ini_get('apc.enabled')) {
+				apc_delete_file($compiledFile);
+			}
+
+			self::$cache['compiled'][$this->compileId] = true;
+		}
+
+		return $compiledFile;
+	}
+
+	/**
+	 * Checks if compiled file is valid (it exists).
+	 *
+	 * @param string $file
+	 *
+	 * @return bool True cache file existance
+	 */
+	protected function isValidCompiledFile($file)
+	{
+		return file_exists($file);
+	}
+
+	/**
+	 * Returns a new template string object with the resource id being the template source code.
+	 *
+	 * @param Core      $core           the dwoo instance requiring it
+	 * @param mixed     $resourceId     the filename (relative to this template's dir) of the template to include
+	 * @param int       $cacheTime      duration of the cache validity for this template, if null it defaults to the
+	 *                                  Dwoo instance that will render this template if null it defaults to the Dwoo
+	 *                                  instance that will render this template
+	 * @param string    $cacheId        the unique cache identifier of this page or anything else that makes this
+	 *                                  template's content unique, if null it defaults to the current url makes this
+	 *                                  template's content unique, if null it defaults to the current url
+	 * @param string    $compileId      the unique compiled identifier, which is used to distinguish this template from
+	 *                                  others, if null it defaults to the filename+bits of the path template from
+	 *                                  others, if null it defaults to the filename+bits of the path
+	 * @param ITemplate $parentTemplate the template that is requesting a new template object (through an include,
+	 *                                  extends or any other plugin) an include, extends or any other plugin)
+	 *
+	 * @return $this
+	 */
+	public static function templateFactory(Core $core, $resourceId, $cacheTime = null, $cacheId = null, $compileId = null, ITemplate $parentTemplate = null)
+	{
+		return new self($resourceId, $cacheTime, $cacheId, $compileId);
+	}
+
+	/**
+	 * Returns the full compiled file name and assigns a default value to it if
+	 * required.
+	 *
+	 * @param Core $core the dwoo instance that requests the file name
+	 *
+	 * @return string the full path to the compiled file
+	 */
+	protected function getCompiledFilename(Core $core)
+	{
+		// no compile id was provided, set default
+		if ($this->compileId === null) {
+			$this->compileId = $this->name;
+		}
+
+		return $core->getCompileDir() . $this->compileId . '.d' . Core::RELEASE_TAG . '.php';
+	}
+
+	/**
+	 * Returns the full cached file name and assigns a default value to it if
+	 * required.
+	 *
+	 * @param Core $core the dwoo instance that requests the file name
+	 *
+	 * @return string the full path to the cached file
+	 */
+	protected function getCacheFilename(Core $core)
+	{
+		// no cache id provided, use request_uri as default
+		if ($this->cacheId === null) {
+			if (isset($_SERVER['REQUEST_URI']) === true) {
+				$cacheId = $_SERVER['REQUEST_URI'];
+			} elseif (isset($_SERVER['SCRIPT_FILENAME']) && isset($_SERVER['argv'])) {
+				$cacheId = $_SERVER['SCRIPT_FILENAME'] . '-' . implode('-', $_SERVER['argv']);
+			} else {
+				$cacheId = '';
+			}
+			// force compiled id generation
+			$this->getCompiledFilename($core);
+
+			$this->cacheId = str_replace('../', '__', $this->compileId . strtr($cacheId, '\\%?=!:;' . PATH_SEPARATOR, '/-------'));
+		}
+
+		return $core->getCacheDir() . $this->cacheId . '.html';
+	}
+
+	/**
+	 * Returns some php code that will check if this template has been modified or not.
+	 * if the function returns null, the template will be instanciated and then the Uid checked
+	 *
+	 * @return string
+	 */
+	public function getIsModifiedCode()
+	{
+		return null;
+	}
+
+	/**
+	 * Ensures the given path exists.
+	 *
+	 * @param string $path    any path
+	 * @param string $baseDir the base directory where the directory is created
+	 *                        ($path must still contain the full path, $baseDir
+	 *                        is only used for unix permissions)
+	 *
+	 * @throws Exception
+	 */
+	protected function makeDirectory($path, $baseDir = null)
+	{
+		if (is_dir($path) === true) {
+			return;
+		}
+
+		if ($this->chmod === null) {
+			$chmod = 0777;
+		} else {
+			$chmod = $this->chmod;
+		}
+
+		$retries = 3;
+		while ($retries --) {
+			@mkdir($path, $chmod, true);
+			if (is_dir($path)) {
+				break;
+			}
+			usleep(20);
+		}
+
+		// enforce the correct mode for all directories created
+		if (strpos(PHP_OS, 'WIN') !== 0 && $baseDir !== null) {
+			$path    = strtr(str_replace($baseDir, '', $path), '\\', '/');
+			$folders = explode('/', trim($path, '/'));
+			foreach ($folders as $folder) {
+				$baseDir .= $folder . DIRECTORY_SEPARATOR;
+				if (!chmod($baseDir, $chmod)) {
+					throw new Exception('Unable to chmod ' . "$baseDir to $chmod: " . print_r(error_get_last(), true));
+				}
+			}
+		}
+	}
 }

lib/Dwoo/Smarty/Filter/Adapter.php

Indentation +17 added lines, -17 removed lines

@@ -23,23 +23,23 @@
  */
 class Adapter extends Processor
 {
-    public $callback;
+	public $callback;
 
-    /**
-     * @param string $input
-     *
-     * @return mixed
-     */
-    public function process($input)
-    {
-        return call_user_func($this->callback, $input);
-    }
+	/**
+	 * @param string $input
+	 *
+	 * @return mixed
+	 */
+	public function process($input)
+	{
+		return call_user_func($this->callback, $input);
+	}
 
-    /**
-     * @param $callback
-     */
-    public function registerCallback($callback)
-    {
-        $this->callback = $callback;
-    }
+	/**
+	 * @param $callback
+	 */
+	public function registerCallback($callback)
+	{
+		$this->callback = $callback;
+	}
 }
\ No newline at end of file

lib/Dwoo/Core.php

Indentation +1671 added lines, -1671 removed lines

@@ -44,1683 +44,1683 @@
  */
 class Core
 {
-    /**
-     * Current version number.
-     *
-     * @var string
-     */
-    const VERSION = '1.3.0';
-
-    /**
-     * Unique number of this dwoo release, based on version number.
-     * this can be used by templates classes to check whether the compiled template
-     * has been compiled before this release or not, so that old templates are
-     * recompiled automatically when Dwoo is updated
-     */
-    const RELEASE_TAG = 130;
-
-    /**
-     * Constants that represents all plugin types
-     * these are bitwise-operation-safe values to allow multiple types
-     * on a single plugin
-     *
-     * @var int
-     */
-    const CLASS_PLUGIN      = 1;
-    const FUNC_PLUGIN       = 2;
-    const NATIVE_PLUGIN     = 4;
-    const BLOCK_PLUGIN      = 8;
-    const COMPILABLE_PLUGIN = 16;
-    const CUSTOM_PLUGIN     = 32;
-    const SMARTY_MODIFIER   = 64;
-    const SMARTY_BLOCK      = 128;
-    const SMARTY_FUNCTION   = 256;
-    const PROXY_PLUGIN      = 512;
-    const TEMPLATE_PLUGIN   = 1024;
-
-    /**
-     * Constant to default namespaces of builtin plugins
-     *
-     * @var string
-     */
-    const NAMESPACE_PLUGINS_BLOCKS     = 'Dwoo\Plugins\Blocks\\';
-    const NAMESPACE_PLUGINS_FILTERS    = 'Dwoo\Plugins\Filters\\';
-    const NAMESPACE_PLUGINS_FUNCTIONS  = 'Dwoo\Plugins\Functions\\';
-    const NAMESPACE_PLUGINS_HELPERS    = 'Dwoo\Plugins\Helpers\\';
-    const NAMESPACE_PLUGINS_PROCESSORS = 'Dwoo\Plugins\Processors\\';
-
-    /**
-     * Character set of the template, used by string manipulation plugins.
-     * it must be lowercase, but setCharset() will take care of that
-     *
-     * @see setCharset
-     * @see getCharset
-     * @var string
-     */
-    protected $charset = 'UTF-8';
-
-    /**
-     * Global variables that are accessible through $dwoo.* in the templates.
-     * default values include:
-     * $dwoo.version - current version number
-     * $dwoo.ad - a Powered by Dwoo link pointing to dwoo.org
-     * $dwoo.now - the current time
-     * $dwoo.template - the current template filename
-     * $dwoo.charset - the character set used by the template
-     * on top of that, foreach and other plugins can store special values in there,
-     * see their documentation for more details.
-     *
-     * @var array
-     */
-    public $globals;
-
-    /**
-     * Directory where the compiled templates are stored.
-     * defaults to DWOO_COMPILEDIR (= dwoo_dir/compiled by default)
-     *
-     * @var string
-     */
-    protected $compileDir;
-
-    /**
-     * Directory where the cached templates are stored.
-     * defaults to DWOO_CACHEDIR (= dwoo_dir/cache by default)
-     *
-     * @var string
-     */
-    protected $cacheDir;
-
-    /**
-     * Defines how long (in seconds) the cached files must remain valid.
-     * can be overridden on a per-template basis
-     * -1 = never delete
-     * 0 = disabled
-     * >0 = duration in seconds
-     *
-     * @var int
-     */
-    protected $cacheTime = 0;
-
-    /**
-     * Security policy object.
-     *
-     * @var SecurityPolicy
-     */
-    protected $securityPolicy = null;
-
-    /**
-     * Stores the custom plugins callbacks.
-     *
-     * @see addPlugin
-     * @see removePlugin
-     * @var array
-     */
-    protected $plugins = array();
-
-    /**
-     * Stores the filter callbacks.
-     *
-     * @see addFilter
-     * @see removeFilter
-     * @var array
-     */
-    protected $filters = array();
-
-    /**
-     * Stores the resource types and associated
-     * classes / compiler classes.
-     *
-     * @var array
-     */
-    protected $resources = array(
-        'file'   => array(
-            'class'    => 'Dwoo\Template\File',
-            'compiler' => null,
-        ),
-        'string' => array(
-            'class'    => 'Dwoo\Template\String',
-            'compiler' => null,
-        ),
-    );
-
-    /**
-     * The dwoo loader object used to load plugins by this dwoo instance.
-     *
-     * @var ILoader
-     */
-    protected $loader = null;
-
-    /**
-     * Currently rendered template, set to null when not-rendering.
-     *
-     * @var ITemplate
-     */
-    protected $template = null;
-
-    /**
-     * Stores the instances of the class plugins during template runtime.
-     *
-     * @var array
-     */
-    protected $runtimePlugins;
-
-    /**
-     * Stores the returned values during template runtime.
-     *
-     * @var array
-     */
-    protected $returnData;
-
-    /**
-     * Stores the data during template runtime.
-     *
-     * @var array
-     */
-    public $data;
-
-    /**
-     * Stores the current scope during template runtime.
-     * this should ideally not be accessed directly from outside template code
-     *
-     * @var mixed
-     */
-    public $scope;
-
-    /**
-     * Stores the scope tree during template runtime.
-     *
-     * @var array
-     */
-    protected $scopeTree;
-
-    /**
-     * Stores the block plugins stack during template runtime.
-     *
-     * @var array
-     */
-    protected $stack;
-
-    /**
-     * Stores the current block plugin at the top of the stack during template runtime.
-     *
-     * @var BlockPlugin
-     */
-    protected $curBlock;
-
-    /**
-     * Stores the output buffer during template runtime.
-     *
-     * @var string
-     */
-    protected $buffer;
-
-    /**
-     * Stores plugin proxy.
-     *
-     * @var IPluginProxy
-     */
-    protected $pluginProxy;
-
-    /**
-     * Constructor, sets the cache and compile dir to the default values if not provided.
-     *
-     * @param string $compileDir path to the compiled directory, defaults to lib/compiled
-     * @param string $cacheDir   path to the cache directory, defaults to lib/cache
-     */
-    public function __construct($compileDir = null, $cacheDir = null)
-    {
-        if ($compileDir !== null) {
-            $this->setCompileDir($compileDir);
-        }
-        if ($cacheDir !== null) {
-            $this->setCacheDir($cacheDir);
-        }
-        $this->initGlobals();
-    }
-
-    /**
-     * Resets some runtime variables to allow a cloned object to be used to render sub-templates.
-     *
-     * @return void
-     */
-    public function __clone()
-    {
-        $this->template = null;
-        unset($this->data);
-        unset($this->returnData);
-    }
-
-    /**
-     * Returns the given template rendered using the provided data and optional compiler.
-     *
-     * @param mixed     $_tpl      template, can either be a ITemplate object (i.e. TemplateFile), a
-     *                             valid path to a template, or a template as a string it is recommended to
-     *                             provide a ITemplate as it will probably make things faster, especially if
-     *                             you render a template multiple times
-     * @param mixed     $data      the data to use, can either be a IDataProvider object (i.e. Data) or
-     *                             an associative array. if you're rendering the template from cache, it can be
-     *                             left null
-     * @param ICompiler $_compiler the compiler that must be used to compile the template, if left empty a default
-     *                             Compiler will be used
-     *
-     * @return string|void or the template output if $output is false
-     * @throws Exception
-     */
-    public function get($_tpl, $data = array(), $_compiler = null)
-    {
-        // a render call came from within a template, so we need a new dwoo instance in order to avoid breaking this one
-        if ($this->template instanceof ITemplate) {
-            $clone = clone $this;
-
-            return $clone->get($_tpl, $data, $_compiler);
-        }
-
-        // auto-create template if required
-        if ($_tpl instanceof ITemplate) {
-            // valid, skip
-        } elseif (is_string($_tpl) && file_exists($_tpl)) {
-            $_tpl = new TemplateFile($_tpl);
-        } else {
-            throw new Exception(
-                'Dwoo->get\'s first argument must be a ITemplate (i.e. TemplateFile) or 
+	/**
+	 * Current version number.
+	 *
+	 * @var string
+	 */
+	const VERSION = '1.3.0';
+
+	/**
+	 * Unique number of this dwoo release, based on version number.
+	 * this can be used by templates classes to check whether the compiled template
+	 * has been compiled before this release or not, so that old templates are
+	 * recompiled automatically when Dwoo is updated
+	 */
+	const RELEASE_TAG = 130;
+
+	/**
+	 * Constants that represents all plugin types
+	 * these are bitwise-operation-safe values to allow multiple types
+	 * on a single plugin
+	 *
+	 * @var int
+	 */
+	const CLASS_PLUGIN      = 1;
+	const FUNC_PLUGIN       = 2;
+	const NATIVE_PLUGIN     = 4;
+	const BLOCK_PLUGIN      = 8;
+	const COMPILABLE_PLUGIN = 16;
+	const CUSTOM_PLUGIN     = 32;
+	const SMARTY_MODIFIER   = 64;
+	const SMARTY_BLOCK      = 128;
+	const SMARTY_FUNCTION   = 256;
+	const PROXY_PLUGIN      = 512;
+	const TEMPLATE_PLUGIN   = 1024;
+
+	/**
+	 * Constant to default namespaces of builtin plugins
+	 *
+	 * @var string
+	 */
+	const NAMESPACE_PLUGINS_BLOCKS     = 'Dwoo\Plugins\Blocks\\';
+	const NAMESPACE_PLUGINS_FILTERS    = 'Dwoo\Plugins\Filters\\';
+	const NAMESPACE_PLUGINS_FUNCTIONS  = 'Dwoo\Plugins\Functions\\';
+	const NAMESPACE_PLUGINS_HELPERS    = 'Dwoo\Plugins\Helpers\\';
+	const NAMESPACE_PLUGINS_PROCESSORS = 'Dwoo\Plugins\Processors\\';
+
+	/**
+	 * Character set of the template, used by string manipulation plugins.
+	 * it must be lowercase, but setCharset() will take care of that
+	 *
+	 * @see setCharset
+	 * @see getCharset
+	 * @var string
+	 */
+	protected $charset = 'UTF-8';
+
+	/**
+	 * Global variables that are accessible through $dwoo.* in the templates.
+	 * default values include:
+	 * $dwoo.version - current version number
+	 * $dwoo.ad - a Powered by Dwoo link pointing to dwoo.org
+	 * $dwoo.now - the current time
+	 * $dwoo.template - the current template filename
+	 * $dwoo.charset - the character set used by the template
+	 * on top of that, foreach and other plugins can store special values in there,
+	 * see their documentation for more details.
+	 *
+	 * @var array
+	 */
+	public $globals;
+
+	/**
+	 * Directory where the compiled templates are stored.
+	 * defaults to DWOO_COMPILEDIR (= dwoo_dir/compiled by default)
+	 *
+	 * @var string
+	 */
+	protected $compileDir;
+
+	/**
+	 * Directory where the cached templates are stored.
+	 * defaults to DWOO_CACHEDIR (= dwoo_dir/cache by default)
+	 *
+	 * @var string
+	 */
+	protected $cacheDir;
+
+	/**
+	 * Defines how long (in seconds) the cached files must remain valid.
+	 * can be overridden on a per-template basis
+	 * -1 = never delete
+	 * 0 = disabled
+	 * >0 = duration in seconds
+	 *
+	 * @var int
+	 */
+	protected $cacheTime = 0;
+
+	/**
+	 * Security policy object.
+	 *
+	 * @var SecurityPolicy
+	 */
+	protected $securityPolicy = null;
+
+	/**
+	 * Stores the custom plugins callbacks.
+	 *
+	 * @see addPlugin
+	 * @see removePlugin
+	 * @var array
+	 */
+	protected $plugins = array();
+
+	/**
+	 * Stores the filter callbacks.
+	 *
+	 * @see addFilter
+	 * @see removeFilter
+	 * @var array
+	 */
+	protected $filters = array();
+
+	/**
+	 * Stores the resource types and associated
+	 * classes / compiler classes.
+	 *
+	 * @var array
+	 */
+	protected $resources = array(
+		'file'   => array(
+			'class'    => 'Dwoo\Template\File',
+			'compiler' => null,
+		),
+		'string' => array(
+			'class'    => 'Dwoo\Template\String',
+			'compiler' => null,
+		),
+	);
+
+	/**
+	 * The dwoo loader object used to load plugins by this dwoo instance.
+	 *
+	 * @var ILoader
+	 */
+	protected $loader = null;
+
+	/**
+	 * Currently rendered template, set to null when not-rendering.
+	 *
+	 * @var ITemplate
+	 */
+	protected $template = null;
+
+	/**
+	 * Stores the instances of the class plugins during template runtime.
+	 *
+	 * @var array
+	 */
+	protected $runtimePlugins;
+
+	/**
+	 * Stores the returned values during template runtime.
+	 *
+	 * @var array
+	 */
+	protected $returnData;
+
+	/**
+	 * Stores the data during template runtime.
+	 *
+	 * @var array
+	 */
+	public $data;
+
+	/**
+	 * Stores the current scope during template runtime.
+	 * this should ideally not be accessed directly from outside template code
+	 *
+	 * @var mixed
+	 */
+	public $scope;
+
+	/**
+	 * Stores the scope tree during template runtime.
+	 *
+	 * @var array
+	 */
+	protected $scopeTree;
+
+	/**
+	 * Stores the block plugins stack during template runtime.
+	 *
+	 * @var array
+	 */
+	protected $stack;
+
+	/**
+	 * Stores the current block plugin at the top of the stack during template runtime.
+	 *
+	 * @var BlockPlugin
+	 */
+	protected $curBlock;
+
+	/**
+	 * Stores the output buffer during template runtime.
+	 *
+	 * @var string
+	 */
+	protected $buffer;
+
+	/**
+	 * Stores plugin proxy.
+	 *
+	 * @var IPluginProxy
+	 */
+	protected $pluginProxy;
+
+	/**
+	 * Constructor, sets the cache and compile dir to the default values if not provided.
+	 *
+	 * @param string $compileDir path to the compiled directory, defaults to lib/compiled
+	 * @param string $cacheDir   path to the cache directory, defaults to lib/cache
+	 */
+	public function __construct($compileDir = null, $cacheDir = null)
+	{
+		if ($compileDir !== null) {
+			$this->setCompileDir($compileDir);
+		}
+		if ($cacheDir !== null) {
+			$this->setCacheDir($cacheDir);
+		}
+		$this->initGlobals();
+	}
+
+	/**
+	 * Resets some runtime variables to allow a cloned object to be used to render sub-templates.
+	 *
+	 * @return void
+	 */
+	public function __clone()
+	{
+		$this->template = null;
+		unset($this->data);
+		unset($this->returnData);
+	}
+
+	/**
+	 * Returns the given template rendered using the provided data and optional compiler.
+	 *
+	 * @param mixed     $_tpl      template, can either be a ITemplate object (i.e. TemplateFile), a
+	 *                             valid path to a template, or a template as a string it is recommended to
+	 *                             provide a ITemplate as it will probably make things faster, especially if
+	 *                             you render a template multiple times
+	 * @param mixed     $data      the data to use, can either be a IDataProvider object (i.e. Data) or
+	 *                             an associative array. if you're rendering the template from cache, it can be
+	 *                             left null
+	 * @param ICompiler $_compiler the compiler that must be used to compile the template, if left empty a default
+	 *                             Compiler will be used
+	 *
+	 * @return string|void or the template output if $output is false
+	 * @throws Exception
+	 */
+	public function get($_tpl, $data = array(), $_compiler = null)
+	{
+		// a render call came from within a template, so we need a new dwoo instance in order to avoid breaking this one
+		if ($this->template instanceof ITemplate) {
+			$clone = clone $this;
+
+			return $clone->get($_tpl, $data, $_compiler);
+		}
+
+		// auto-create template if required
+		if ($_tpl instanceof ITemplate) {
+			// valid, skip
+		} elseif (is_string($_tpl) && file_exists($_tpl)) {
+			$_tpl = new TemplateFile($_tpl);
+		} else {
+			throw new Exception(
+				'Dwoo->get\'s first argument must be a ITemplate (i.e. TemplateFile) or 
             a valid path to a template file', E_USER_NOTICE
-            );
-        }
-
-        // save the current template, enters render mode at the same time
-        // if another rendering is requested it will be proxied to a new Core(instance
-        $this->template = $_tpl;
-
-        // load data
-        if ($data instanceof IDataProvider) {
-            $this->data = $data->getData();
-        } elseif (is_array($data)) {
-            $this->data = $data;
-        } elseif ($data instanceof ArrayAccess) {
-            $this->data = $data;
-        } else {
-            throw new Exception(
-                'Dwoo->get/Dwoo->output\'s data argument must be a IDataProvider object (i.e. Data) or
+			);
+		}
+
+		// save the current template, enters render mode at the same time
+		// if another rendering is requested it will be proxied to a new Core(instance
+		$this->template = $_tpl;
+
+		// load data
+		if ($data instanceof IDataProvider) {
+			$this->data = $data->getData();
+		} elseif (is_array($data)) {
+			$this->data = $data;
+		} elseif ($data instanceof ArrayAccess) {
+			$this->data = $data;
+		} else {
+			throw new Exception(
+				'Dwoo->get/Dwoo->output\'s data argument must be a IDataProvider object (i.e. Data) or
             an associative array', E_USER_NOTICE
-            );
-        }
-
-        $this->globals['template'] = $_tpl->getName();
-        $this->initRuntimeVars($_tpl);
-
-        // try to get cached template
-        $file        = $_tpl->getCachedTemplate($this);
-        $doCache     = $file === true;
-        $cacheLoaded = is_string($file);
-
-        if ($cacheLoaded === true) {
-            // cache is present, run it
-            ob_start();
-            include $file;
-            $this->template = null;
-
-            return ob_get_clean();
-        } else {
-            $dynamicId = uniqid();
-
-            // render template
-            $compiledTemplate = $_tpl->getCompiledTemplate($this, $_compiler);
-            $out              = include $compiledTemplate;
-
-            // template returned false so it needs to be recompiled
-            if ($out === false) {
-                $_tpl->forceCompilation();
-                $compiledTemplate = $_tpl->getCompiledTemplate($this, $_compiler);
-                $out              = include $compiledTemplate;
-            }
-
-            if ($doCache === true) {
-                $out = preg_replace('/(<%|%>|<\?php|<\?|\?>)/', '<?php /*' . $dynamicId . '*/ echo \'$1\'; ?>', $out);
-                if (!class_exists(self::NAMESPACE_PLUGINS_BLOCKS . 'PluginDynamic')) {
-                    $this->getLoader()->loadPlugin('PluginDynamic');
-                }
-                $out = PluginDynamic::unescape($out, $dynamicId, $compiledTemplate);
-            }
-
-            // process filters
-            foreach ($this->filters as $filter) {
-                if (is_array($filter) && $filter[0] instanceof Filter) {
-                    $out = call_user_func($filter, $out);
-                } else {
-                    $out = call_user_func($filter, $this, $out);
-                }
-            }
-
-            if ($doCache === true) {
-                // building cache
-                $file = $_tpl->cache($this, $out);
-
-                // run it from the cache to be sure dynamics are rendered
-                ob_start();
-                include $file;
-                // exit render mode
-                $this->template = null;
-
-                return ob_get_clean();
-            } else {
-                // no need to build cache
-                // exit render mode
-                $this->template = null;
-
-                return $out;
-            }
-        }
-    }
-
-    /**
-     * Re-initializes the globals array before each template run.
-     * this method is only callede once when the Dwoo object is created
-     *
-     * @return void
-     */
-    protected function initGlobals()
-    {
-        $this->globals = array(
-            'version' => self::VERSION,
-            'ad'      => '<a href="http://dwoo.org/">Powered by Dwoo</a>',
-            'now'     => $_SERVER['REQUEST_TIME'],
-            'charset' => $this->charset,
-        );
-    }
-
-    /**
-     * Re-initializes the runtime variables before each template run.
-     * override this method to inject data in the globals array if needed, this
-     * method is called before each template execution
-     *
-     * @param ITemplate $tpl the template that is going to be rendered
-     *
-     * @return void
-     */
-    protected function initRuntimeVars(ITemplate $tpl)
-    {
-        $this->runtimePlugins = array();
-        $this->scope          = &$this->data;
-        $this->scopeTree      = array();
-        $this->stack          = array();
-        $this->curBlock       = null;
-        $this->buffer         = '';
-        $this->returnData     = array();
-    }
-
-    /**
-     * Adds a custom plugin that is not in one of the plugin directories.
-     *
-     * @param string   $name       the plugin name to be used in the templates
-     * @param callback $callback   the plugin callback, either a function name,
-     *                             a class name or an array containing an object
-     *                             or class name and a method name
-     * @param bool     $compilable if set to true, the plugin is assumed to be compilable
-     *
-     * @return void
-     * @throws Exception
-     */
-    public function addPlugin($name, $callback, $compilable = false)
-    {
-        $compilable = $compilable ? self::COMPILABLE_PLUGIN : 0;
-        if (is_array($callback)) {
-            if (is_subclass_of(is_object($callback[0]) ? get_class($callback[0]) : $callback[0], 'Dwoo\Block\Plugin')) {
-                $this->plugins[$name] = array(
-                    'type'     => self::BLOCK_PLUGIN | $compilable,
-                    'callback' => $callback,
-                    'class'    => (is_object($callback[0]) ? get_class($callback[0]) : $callback[0])
-                );
-            } else {
-                $this->plugins[$name] = array(
-                    'type'     => self::CLASS_PLUGIN | $compilable,
-                    'callback' => $callback,
-                    'class'    => (is_object($callback[0]) ? get_class($callback[0]) : $callback[0]),
-                    'function' => $callback[1]
-                );
-            }
-        } elseif (is_string($callback)) {
-            if (class_exists($callback)) {
-                if (is_subclass_of($callback, 'Dwoo\Block\Plugin')) {
-                    $this->plugins[$name] = array(
-                        'type'     => self::BLOCK_PLUGIN | $compilable,
-                        'callback' => $callback,
-                        'class'    => $callback
-                    );
-                } else {
-                    $this->plugins[$name] = array(
-                        'type'     => self::CLASS_PLUGIN | $compilable,
-                        'callback' => $callback,
-                        'class'    => $callback,
-                        'function' => ($compilable ? 'compile' : 'process')
-                    );
-                }
-            } elseif (function_exists($callback)) {
-                $this->plugins[$name] = array(
-                    'type'     => self::FUNC_PLUGIN | $compilable,
-                    'callback' => $callback
-                );
-            } else {
-                throw new Exception(
-                    'Callback could not be processed correctly, please check that the function/class 
+			);
+		}
+
+		$this->globals['template'] = $_tpl->getName();
+		$this->initRuntimeVars($_tpl);
+
+		// try to get cached template
+		$file        = $_tpl->getCachedTemplate($this);
+		$doCache     = $file === true;
+		$cacheLoaded = is_string($file);
+
+		if ($cacheLoaded === true) {
+			// cache is present, run it
+			ob_start();
+			include $file;
+			$this->template = null;
+
+			return ob_get_clean();
+		} else {
+			$dynamicId = uniqid();
+
+			// render template
+			$compiledTemplate = $_tpl->getCompiledTemplate($this, $_compiler);
+			$out              = include $compiledTemplate;
+
+			// template returned false so it needs to be recompiled
+			if ($out === false) {
+				$_tpl->forceCompilation();
+				$compiledTemplate = $_tpl->getCompiledTemplate($this, $_compiler);
+				$out              = include $compiledTemplate;
+			}
+
+			if ($doCache === true) {
+				$out = preg_replace('/(<%|%>|<\?php|<\?|\?>)/', '<?php /*' . $dynamicId . '*/ echo \'$1\'; ?>', $out);
+				if (!class_exists(self::NAMESPACE_PLUGINS_BLOCKS . 'PluginDynamic')) {
+					$this->getLoader()->loadPlugin('PluginDynamic');
+				}
+				$out = PluginDynamic::unescape($out, $dynamicId, $compiledTemplate);
+			}
+
+			// process filters
+			foreach ($this->filters as $filter) {
+				if (is_array($filter) && $filter[0] instanceof Filter) {
+					$out = call_user_func($filter, $out);
+				} else {
+					$out = call_user_func($filter, $this, $out);
+				}
+			}
+
+			if ($doCache === true) {
+				// building cache
+				$file = $_tpl->cache($this, $out);
+
+				// run it from the cache to be sure dynamics are rendered
+				ob_start();
+				include $file;
+				// exit render mode
+				$this->template = null;
+
+				return ob_get_clean();
+			} else {
+				// no need to build cache
+				// exit render mode
+				$this->template = null;
+
+				return $out;
+			}
+		}
+	}
+
+	/**
+	 * Re-initializes the globals array before each template run.
+	 * this method is only callede once when the Dwoo object is created
+	 *
+	 * @return void
+	 */
+	protected function initGlobals()
+	{
+		$this->globals = array(
+			'version' => self::VERSION,
+			'ad'      => '<a href="http://dwoo.org/">Powered by Dwoo</a>',
+			'now'     => $_SERVER['REQUEST_TIME'],
+			'charset' => $this->charset,
+		);
+	}
+
+	/**
+	 * Re-initializes the runtime variables before each template run.
+	 * override this method to inject data in the globals array if needed, this
+	 * method is called before each template execution
+	 *
+	 * @param ITemplate $tpl the template that is going to be rendered
+	 *
+	 * @return void
+	 */
+	protected function initRuntimeVars(ITemplate $tpl)
+	{
+		$this->runtimePlugins = array();
+		$this->scope          = &$this->data;
+		$this->scopeTree      = array();
+		$this->stack          = array();
+		$this->curBlock       = null;
+		$this->buffer         = '';
+		$this->returnData     = array();
+	}
+
+	/**
+	 * Adds a custom plugin that is not in one of the plugin directories.
+	 *
+	 * @param string   $name       the plugin name to be used in the templates
+	 * @param callback $callback   the plugin callback, either a function name,
+	 *                             a class name or an array containing an object
+	 *                             or class name and a method name
+	 * @param bool     $compilable if set to true, the plugin is assumed to be compilable
+	 *
+	 * @return void
+	 * @throws Exception
+	 */
+	public function addPlugin($name, $callback, $compilable = false)
+	{
+		$compilable = $compilable ? self::COMPILABLE_PLUGIN : 0;
+		if (is_array($callback)) {
+			if (is_subclass_of(is_object($callback[0]) ? get_class($callback[0]) : $callback[0], 'Dwoo\Block\Plugin')) {
+				$this->plugins[$name] = array(
+					'type'     => self::BLOCK_PLUGIN | $compilable,
+					'callback' => $callback,
+					'class'    => (is_object($callback[0]) ? get_class($callback[0]) : $callback[0])
+				);
+			} else {
+				$this->plugins[$name] = array(
+					'type'     => self::CLASS_PLUGIN | $compilable,
+					'callback' => $callback,
+					'class'    => (is_object($callback[0]) ? get_class($callback[0]) : $callback[0]),
+					'function' => $callback[1]
+				);
+			}
+		} elseif (is_string($callback)) {
+			if (class_exists($callback)) {
+				if (is_subclass_of($callback, 'Dwoo\Block\Plugin')) {
+					$this->plugins[$name] = array(
+						'type'     => self::BLOCK_PLUGIN | $compilable,
+						'callback' => $callback,
+						'class'    => $callback
+					);
+				} else {
+					$this->plugins[$name] = array(
+						'type'     => self::CLASS_PLUGIN | $compilable,
+						'callback' => $callback,
+						'class'    => $callback,
+						'function' => ($compilable ? 'compile' : 'process')
+					);
+				}
+			} elseif (function_exists($callback)) {
+				$this->plugins[$name] = array(
+					'type'     => self::FUNC_PLUGIN | $compilable,
+					'callback' => $callback
+				);
+			} else {
+				throw new Exception(
+					'Callback could not be processed correctly, please check that the function/class 
                 you used exists'
-                );
-            }
-        } elseif ($callback instanceof Closure) {
-            $this->plugins[$name] = array(
-                'type'     => self::FUNC_PLUGIN | $compilable,
-                'callback' => $callback
-            );
-        } else {
-            throw new Exception(
-                'Callback could not be processed correctly, please check that the function/class you 
+				);
+			}
+		} elseif ($callback instanceof Closure) {
+			$this->plugins[$name] = array(
+				'type'     => self::FUNC_PLUGIN | $compilable,
+				'callback' => $callback
+			);
+		} else {
+			throw new Exception(
+				'Callback could not be processed correctly, please check that the function/class you 
             used exists'
-            );
-        }
-    }
-
-    /**
-     * Removes a custom plugin.
-     *
-     * @param string $name the plugin name
-     *
-     * @return void
-     */
-    public function removePlugin($name)
-    {
-        if (isset($this->plugins[$name])) {
-            unset($this->plugins[$name]);
-        }
-    }
-
-    /**
-     * Adds a filter to this Dwoo instance, it will be used to filter the output of all the templates rendered by this
-     * instance.
-     *
-     * @param mixed $callback a callback or a filter name if it is autoloaded from a plugin directory
-     * @param bool  $autoload if true, the first parameter must be a filter name from one of the plugin directories
-     *
-     * @return void
-     * @throws Exception
-     */
-    public function addFilter($callback, $autoload = false)
-    {
-        if ($autoload) {
-            $class = self::NAMESPACE_PLUGINS_FILTERS . self::toCamelCase($callback);
-            if (!class_exists($class) && !function_exists($class)) {
-                try {
-                    $this->getLoader()->loadPlugin($callback);
-                }
-                catch (Exception $e) {
-                    if (strstr($callback, self::NAMESPACE_PLUGINS_FILTERS)) {
-                        throw new Exception(
-                            'Wrong filter name : ' . $callback . ', the "Dwoo_Filter_" prefix should 
+			);
+		}
+	}
+
+	/**
+	 * Removes a custom plugin.
+	 *
+	 * @param string $name the plugin name
+	 *
+	 * @return void
+	 */
+	public function removePlugin($name)
+	{
+		if (isset($this->plugins[$name])) {
+			unset($this->plugins[$name]);
+		}
+	}
+
+	/**
+	 * Adds a filter to this Dwoo instance, it will be used to filter the output of all the templates rendered by this
+	 * instance.
+	 *
+	 * @param mixed $callback a callback or a filter name if it is autoloaded from a plugin directory
+	 * @param bool  $autoload if true, the first parameter must be a filter name from one of the plugin directories
+	 *
+	 * @return void
+	 * @throws Exception
+	 */
+	public function addFilter($callback, $autoload = false)
+	{
+		if ($autoload) {
+			$class = self::NAMESPACE_PLUGINS_FILTERS . self::toCamelCase($callback);
+			if (!class_exists($class) && !function_exists($class)) {
+				try {
+					$this->getLoader()->loadPlugin($callback);
+				}
+				catch (Exception $e) {
+					if (strstr($callback, self::NAMESPACE_PLUGINS_FILTERS)) {
+						throw new Exception(
+							'Wrong filter name : ' . $callback . ', the "Dwoo_Filter_" prefix should 
                         not be used, please only use "' . str_replace('Dwoo_Filter_', '', $callback) . '"'
-                        );
-                    } else {
-                        throw new Exception(
-                            'Wrong filter name : ' . $callback . ', when using autoload the filter must
+						);
+					} else {
+						throw new Exception(
+							'Wrong filter name : ' . $callback . ', when using autoload the filter must
                          be in one of your plugin dir as "name.php" containig a class or function named
                          "Dwoo_Filter_name"'
-                        );
-                    }
-                }
-            }
-
-            if (class_exists($class)) {
-                $callback = array(new $class($this), 'process');
-            } elseif (function_exists($class)) {
-                $callback = $class;
-            } else {
-                throw new Exception(
-                    'Wrong filter name : ' . $callback . ', when using autoload the filter must be in
+						);
+					}
+				}
+			}
+
+			if (class_exists($class)) {
+				$callback = array(new $class($this), 'process');
+			} elseif (function_exists($class)) {
+				$callback = $class;
+			} else {
+				throw new Exception(
+					'Wrong filter name : ' . $callback . ', when using autoload the filter must be in
                 one of your plugin dir as "name.php" containig a class or function named "Dwoo_Filter_name"'
-                );
-            }
-
-            $this->filters[] = $callback;
-        } else {
-            $this->filters[] = $callback;
-        }
-    }
-
-    /**
-     * Removes a filter.
-     *
-     * @param mixed $callback callback or filter name if it was autoloaded
-     *
-     * @return void
-     */
-    public function removeFilter($callback)
-    {
-        if (($index = array_search(self::NAMESPACE_PLUGINS_FILTERS. 'Filter' . self::toCamelCase($callback), $this->filters,
-                true)) !==
-            false) {
-            unset($this->filters[$index]);
-        } elseif (($index = array_search($callback, $this->filters, true)) !== false) {
-            unset($this->filters[$index]);
-        } else {
-            $class = self::NAMESPACE_PLUGINS_FILTERS . 'Filter' . $callback;
-            foreach ($this->filters as $index => $filter) {
-                if (is_array($filter) && $filter[0] instanceof $class) {
-                    unset($this->filters[$index]);
-                    break;
-                }
-            }
-        }
-    }
-
-    /**
-     * Adds a resource or overrides a default one.
-     *
-     * @param string   $name            the resource name
-     * @param string   $class           the resource class (which must implement ITemplate)
-     * @param callback $compilerFactory the compiler factory callback, a function that must return a compiler instance
-     *                                  used to compile this resource, if none is provided. by default it will produce
-     *                                  a Compiler object
-     *
-     * @return void
-     * @throws Exception
-     */
-    public function addResource($name, $class, $compilerFactory = null)
-    {
-        if (strlen($name) < 2) {
-            throw new Exception('Resource names must be at least two-character long to avoid conflicts with Windows paths');
-        }
-
-        if (!class_exists($class)) {
-            throw new Exception('Resource class does not exist');
-        }
-
-        $interfaces = class_implements($class);
-        if (in_array('Dwoo\ITemplate', $interfaces) === false) {
-            throw new Exception('Resource class must implement ITemplate');
-        }
-
-        $this->resources[$name] = array(
-            'class'    => $class,
-            'compiler' => $compilerFactory
-        );
-    }
-
-    /**
-     * Removes a custom resource.
-     *
-     * @param string $name the resource name
-     *
-     * @return void
-     */
-    public function removeResource($name)
-    {
-        unset($this->resources[$name]);
-        if ($name === 'file') {
-            $this->resources['file'] = array(
-                'class'    => 'Dwoo\Template\File',
-                'compiler' => null
-            );
-        }
-    }
-
-    /**
-     * Sets the loader object to use to load plugins.
-     *
-     * @param ILoader $loader loader
-     *
-     * @return void
-     */
-    public function setLoader(ILoader $loader)
-    {
-        $this->loader = $loader;
-    }
-
-    /**
-     * Returns the current loader object or a default one if none is currently found.
-     *
-     * @return ILoader|Loader
-     */
-    public function getLoader()
-    {
-        if ($this->loader === null) {
-            $this->loader = new Loader($this->getCompileDir());
-        }
-
-        return $this->loader;
-    }
-
-    /**
-     * Returns the custom plugins loaded.
-     * Used by the ITemplate classes to pass the custom plugins to their ICompiler instance.
-     *
-     * @return array
-     */
-    public function getCustomPlugins()
-    {
-        return $this->plugins;
-    }
-
-    /**
-     * Return a specified custom plugin loaded by his name.
-     * Used by the compiler, for executing a Closure.
-     *
-     * @param string $name
-     *
-     * @return mixed|null
-     */
-    public function getCustomPlugin($name)
-    {
-        if (isset($this->plugins[$name])) {
-            return $this->plugins[$name]['callback'];
-        }
-
-        return null;
-    }
-
-    /**
-     * Returns the cache directory with a trailing DIRECTORY_SEPARATOR.
-     *
-     * @return string
-     */
-    public function getCacheDir()
-    {
-        if ($this->cacheDir === null) {
-            $this->setCacheDir(dirname(__DIR__) . DIRECTORY_SEPARATOR . 'cache' . DIRECTORY_SEPARATOR);
-        }
-
-        return $this->cacheDir;
-    }
-
-    /**
-     * Sets the cache directory and automatically appends a DIRECTORY_SEPARATOR.
-     *
-     * @param string $dir the cache directory
-     *
-     * @return void
-     * @throws Exception
-     */
-    public function setCacheDir($dir)
-    {
-        $this->cacheDir = rtrim($dir, '/\\') . DIRECTORY_SEPARATOR;
-        if (is_writable($this->cacheDir) === false) {
-            throw new Exception('The cache directory must be writable, chmod "' . $this->cacheDir . '" to make it writable');
-        }
-    }
-
-    /**
-     * Returns the compile directory with a trailing DIRECTORY_SEPARATOR.
-     *
-     * @return string
-     */
-    public function getCompileDir()
-    {
-        if ($this->compileDir === null) {
-            $this->setCompileDir(dirname(__DIR__) . DIRECTORY_SEPARATOR . 'compiled' . DIRECTORY_SEPARATOR);
-        }
-
-        return $this->compileDir;
-    }
-
-    /**
-     * Sets the compile directory and automatically appends a DIRECTORY_SEPARATOR.
-     *
-     * @param string $dir the compile directory
-     *
-     * @return void
-     * @throws Exception
-     */
-    public function setCompileDir($dir)
-    {
-        $this->compileDir = rtrim($dir, '/\\') . DIRECTORY_SEPARATOR;
-        if (is_writable($this->compileDir) === false) {
-            throw new Exception('The compile directory must be writable, chmod "' . $this->compileDir . '" to make it writable');
-        }
-    }
-
-    /**
-     * Returns the default cache time that is used with templates that do not have a cache time set.
-     *
-     * @return int the duration in seconds
-     */
-    public function getCacheTime()
-    {
-        return $this->cacheTime;
-    }
-
-    /**
-     * Sets the default cache time to use with templates that do not have a cache time set.
-     *
-     * @param int $seconds the duration in seconds
-     *
-     * @return void
-     */
-    public function setCacheTime($seconds)
-    {
-        $this->cacheTime = (int)$seconds;
-    }
-
-    /**
-     * Returns the character set used by the string manipulation plugins.
-     * the charset is automatically lowercased
-     *
-     * @return string
-     */
-    public function getCharset()
-    {
-        return $this->charset;
-    }
-
-    /**
-     * Sets the character set used by the string manipulation plugins.
-     * the charset will be automatically lowercased
-     *
-     * @param string $charset the character set
-     *
-     * @return void
-     */
-    public function setCharset($charset)
-    {
-        $this->charset = strtolower((string)$charset);
-    }
-
-    /**
-     * Returns the current template being rendered, when applicable, or null.
-     *
-     * @return ITemplate|null
-     */
-    public function getTemplate()
-    {
-        return $this->template;
-    }
-
-    /**
-     * Sets the current template being rendered.
-     *
-     * @param ITemplate $tpl template object
-     *
-     * @return void
-     */
-    public function setTemplate(ITemplate $tpl)
-    {
-        $this->template = $tpl;
-    }
-
-    /**
-     * Sets the default compiler factory function for the given resource name.
-     * a compiler factory must return a ICompiler object pre-configured to fit your needs
-     *
-     * @param string   $resourceName    the resource name (i.e. file, string)
-     * @param callback $compilerFactory the compiler factory callback
-     *
-     * @return void
-     */
-    public function setDefaultCompilerFactory($resourceName, $compilerFactory)
-    {
-        $this->resources[$resourceName]['compiler'] = $compilerFactory;
-    }
-
-    /**
-     * Returns the default compiler factory function for the given resource name.
-     *
-     * @param string $resourceName the resource name
-     *
-     * @return callback the compiler factory callback
-     */
-    public function getDefaultCompilerFactory($resourceName)
-    {
-        return $this->resources[$resourceName]['compiler'];
-    }
-
-    /**
-     * Sets the security policy object to enforce some php security settings.
-     * use this if untrusted persons can modify templates
-     *
-     * @param SecurityPolicy $policy the security policy object
-     *
-     * @return void
-     */
-    public function setSecurityPolicy(SecurityPolicy $policy = null)
-    {
-        $this->securityPolicy = $policy;
-    }
-
-    /**
-     * Returns the current security policy object or null by default.
-     *
-     * @return SecurityPolicy|null the security policy object if any
-     */
-    public function getSecurityPolicy()
-    {
-        return $this->securityPolicy;
-    }
-
-    /**
-     * Sets the object that must be used as a plugin proxy when plugin can't be found
-     * by dwoo's loader.
-     *
-     * @param IPluginProxy $pluginProxy the proxy object
-     *
-     * @return void
-     */
-    public function setPluginProxy(IPluginProxy $pluginProxy)
-    {
-        $this->pluginProxy = $pluginProxy;
-    }
-
-    /**
-     * Returns the current plugin proxy object or null by default.
-     *
-     * @return IPluginProxy
-     */
-    public function getPluginProxy()
-    {
-        return $this->pluginProxy;
-    }
-
-    /**
-     * Checks whether the given template is cached or not.
-     *
-     * @param ITemplate $tpl the template object
-     *
-     * @return bool
-     */
-    public function isCached(ITemplate $tpl)
-    {
-        return is_string($tpl->getCachedTemplate($this));
-    }
-
-    /**
-     * Clear templates inside the compiled directory.
-     *
-     * @return int
-     */
-    public function clearCompiled()
-    {
-        $iterator = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($this->getCompileDir()), \RecursiveIteratorIterator::SELF_FIRST);
-        $count    = 0;
-        foreach ($iterator as $file) {
-            if ($file->isFile()) {
-                $count += unlink($file->__toString()) ? 1 : 0;
-            }
-        }
-
-        return $count;
-    }
-
-    /**
-     * Clears the cached templates if they are older than the given time.
-     *
-     * @param int $olderThan minimum time (in seconds) required for a cached template to be cleared
-     *
-     * @return int the amount of templates cleared
-     */
-    public function clearCache($olderThan = - 1)
-    {
-        $iterator = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($this->getCacheDir()), \RecursiveIteratorIterator::SELF_FIRST);
-        $expired  = time() - $olderThan;
-        $count    = 0;
-        foreach ($iterator as $file) {
-            if ($file->isFile() && $file->getCTime() < $expired) {
-                $count += unlink((string)$file) ? 1 : 0;
-            }
-        }
-
-        return $count;
-    }
-
-    /**
-     * Fetches a template object of the given resource.
-     *
-     * @param string    $resourceName   the resource name (i.e. file, string)
-     * @param string    $resourceId     the resource identifier (i.e. file path)
-     * @param int       $cacheTime      the cache time setting for this resource
-     * @param string    $cacheId        the unique cache identifier
-     * @param string    $compileId      the unique compiler identifier
-     * @param ITemplate $parentTemplate the parent template
-     *
-     * @return ITemplate
-     * @throws Exception
-     */
-    public function templateFactory($resourceName, $resourceId, $cacheTime = null, $cacheId = null, $compileId = null, ITemplate $parentTemplate = null)
-    {
-        if (isset($this->resources[$resourceName])) {
-            /**
-             * Interface ITemplate
-             *
-             * @var ITemplate $class
-             */
-            $class = $this->resources[$resourceName]['class'];
-
-            return $class::templateFactory($this, $resourceId, $cacheTime, $cacheId, $compileId, $parentTemplate);
-        }
-
-        throw new Exception('Unknown resource type : ' . $resourceName);
-    }
-
-    /**
-     * Checks if the input is an array or arrayaccess object, optionally it can also check if it's
-     * empty.
-     *
-     * @param mixed $value        the variable to check
-     * @param bool  $checkIsEmpty if true, the function will also check if the array|arrayaccess is empty,
-     *                            and return true only if it's not empty
-     *
-     * @return int|bool true if it's an array|arrayaccess (or the item count if $checkIsEmpty is true) or false if it's
-     *                  not an array|arrayaccess (or 0 if $checkIsEmpty is true)
-     */
-    public function isArray($value, $checkIsEmpty = false)
-    {
-        if (is_array($value) === true || $value instanceof ArrayAccess) {
-            if ($checkIsEmpty === false) {
-                return true;
-            }
-
-            return $this->count($value);
-        }
-
-        return false;
-    }
-
-    /**
-     * Checks if the input is an array or a traversable object, optionally it can also check if it's
-     * empty.
-     *
-     * @param mixed $value        the variable to check
-     * @param bool  $checkIsEmpty if true, the function will also check if the array|traversable is empty,
-     *                            and return true only if it's not empty
-     *
-     * @return int|bool true if it's an array|traversable (or the item count if $checkIsEmpty is true) or false if it's
-     *                  not an array|traversable (or 0 if $checkIsEmpty is true)
-     */
-    public function isTraversable($value, $checkIsEmpty = false)
-    {
-        if (is_array($value) === true) {
-            if ($checkIsEmpty === false) {
-                return true;
-            } else {
-                return count($value) > 0;
-            }
-        } elseif ($value instanceof Traversable) {
-            if ($checkIsEmpty === false) {
-                return true;
-            } else {
-                return $this->count($value);
-            }
-        }
-
-        return false;
-    }
-
-    /**
-     * Counts an array or arrayaccess/traversable object.
-     *
-     * @param mixed $value the value to count
-     *
-     * @return int|bool the count for arrays and objects that implement countable, true for other objects that don't,
-     *                  and 0 for empty elements
-     */
-    public function count($value)
-    {
-        if (is_array($value) === true || $value instanceof Countable) {
-            return count($value);
-        } elseif ($value instanceof ArrayAccess) {
-            if ($value->offsetExists(0)) {
-                return true;
-            }
-        } elseif ($value instanceof Iterator) {
-            $value->rewind();
-            if ($value->valid()) {
-                return true;
-            }
-        } elseif ($value instanceof Traversable) {
-            foreach ($value as $dummy) {
-                return true;
-            }
-        }
-
-        return 0;
-    }
-
-    /**
-     * Triggers a dwoo error.
-     *
-     * @param string $message the error message
-     * @param int    $level   the error level, one of the PHP's E_* constants
-     *
-     * @return void
-     */
-    public function triggerError($message, $level = E_USER_NOTICE)
-    {
-        if (!($tplIdentifier = $this->template->getResourceIdentifier())) {
-            $tplIdentifier = $this->template->getResourceName();
-        }
-        trigger_error('Dwoo error (in ' . $tplIdentifier . ') : ' . $message, $level);
-    }
-
-    /**
-     * Adds a block to the block stack.
-     *
-     * @param string $blockName the block name (without Dwoo_Plugin_ prefix)
-     * @param array  $args      the arguments to be passed to the block's init() function
-     *
-     * @return BlockPlugin the newly created block
-     */
-    public function addStack($blockName, array $args = array())
-    {
-        if (isset($this->plugins[$blockName])) {
-            $class = $this->plugins[$blockName]['class'];
-        } else {
-            $class = self::NAMESPACE_PLUGINS_BLOCKS . 'Plugin' . self::toCamelCase($blockName);
-        }
-
-        if ($this->curBlock !== null) {
-            $this->curBlock->buffer(ob_get_contents());
-            ob_clean();
-        } else {
-            $this->buffer .= ob_get_contents();
-            ob_clean();
-        }
-
-        $block = new $class($this);
-
-        call_user_func_array(array($block, 'init'), $args);
-
-        $this->stack[] = $this->curBlock = $block;
-
-        return $block;
-    }
-
-    /**
-     * Removes the plugin at the top of the block stack.
-     * Calls the block buffer() function, followed by a call to end() and finally a call to process()
-     *
-     * @return void
-     */
-    public function delStack()
-    {
-        $args = func_get_args();
-
-        $this->curBlock->buffer(ob_get_contents());
-        ob_clean();
-
-        call_user_func_array(array($this->curBlock, 'end'), $args);
-
-        $tmp = array_pop($this->stack);
-
-        if (count($this->stack) > 0) {
-            $this->curBlock = end($this->stack);
-            $this->curBlock->buffer($tmp->process());
-        } else {
-            if ($this->buffer !== '') {
-                echo $this->buffer;
-                $this->buffer = '';
-            }
-            $this->curBlock = null;
-            echo $tmp->process();
-        }
-
-        unset($tmp);
-    }
-
-    /**
-     * Returns the parent block of the given block.
-     *
-     * @param BlockPlugin $block the block class plugin
-     *
-     * @return BlockPlugin|false if the given block isn't in the stack
-     */
-    public function getParentBlock(BlockPlugin $block)
-    {
-        $index = array_search($block, $this->stack, true);
-        if ($index !== false && $index > 0) {
-            return $this->stack[$index - 1];
-        }
-
-        return false;
-    }
-
-    /**
-     * Finds the closest block of the given type, starting at the top of the stack.
-     *
-     * @param string $type the type of plugin you want to find
-     *
-     * @return BlockPlugin|false if no plugin of such type is in the stack
-     */
-    public function findBlock($type)
-    {
-        if (isset($this->plugins[$type])) {
-            $type = $this->plugins[$type]['class'];
-        } else {
-            $type = self::NAMESPACE_PLUGINS_BLOCKS . 'Plugin_' . str_replace(self::NAMESPACE_PLUGINS_BLOCKS.'Plugin',
-                    '', $type);
-        }
-
-        $keys = array_keys($this->stack);
-        while (($key = array_pop($keys)) !== false) {
-            if ($this->stack[$key] instanceof $type) {
-                return $this->stack[$key];
-            }
-        }
-
-        return false;
-    }
-
-    /**
-     * Returns a Plugin of the given class.
-     * this is so a single instance of every class plugin is created at each template run,
-     * allowing class plugins to have "per-template-run" static variables
-     *
-     * @param string $class the class name
-     *
-     * @return mixed an object of the given class
-     */
-    public function getObjectPlugin($class)
-    {
-        if (isset($this->runtimePlugins[$class])) {
-            return $this->runtimePlugins[$class];
-        }
-
-        return $this->runtimePlugins[$class] = new $class($this);
-    }
-
-    /**
-     * Calls the process() method of the given class-plugin name.
-     *
-     * @param string $plugName the class plugin name (without Dwoo_Plugin_ prefix)
-     * @param array  $params   an array of parameters to send to the process() method
-     *
-     * @return string the process() return value
-     */
-    public function classCall($plugName, array $params = array())
-    {
-        $class  = self::toCamelCase($plugName);
-        $plugin = $this->getObjectPlugin($class);
-
-        return call_user_func_array(array($plugin, 'process'), $params);
-    }
-
-    /**
-     * Calls a php function.
-     *
-     * @param string $callback the function to call
-     * @param array  $params   an array of parameters to send to the function
-     *
-     * @return mixed the return value of the called function
-     */
-    public function arrayMap($callback, array $params)
-    {
-        if ($params[0] === $this) {
-            $addThis = true;
-            array_shift($params);
-        }
-        if ((is_array($params[0]) || ($params[0] instanceof Iterator && $params[0] instanceof ArrayAccess))) {
-            if (empty($params[0])) {
-                return $params[0];
-            }
-
-            // array map
-            $out = array();
-            $cnt = count($params);
-
-            if (isset($addThis)) {
-                array_unshift($params, $this);
-                $items = $params[1];
-                $keys  = array_keys($items);
-
-                if (is_string($callback) === false) {
-                    while (($i = array_shift($keys)) !== null) {
-                        $out[] = call_user_func_array($callback, array(1 => $items[$i]) + $params);
-                    }
-                } elseif ($cnt === 1) {
-                    while (($i = array_shift($keys)) !== null) {
-                        $out[] = $callback($this, $items[$i]);
-                    }
-                } elseif ($cnt === 2) {
-                    while (($i = array_shift($keys)) !== null) {
-                        $out[] = $callback($this, $items[$i], $params[2]);
-                    }
-                } elseif ($cnt === 3) {
-                    while (($i = array_shift($keys)) !== null) {
-                        $out[] = $callback($this, $items[$i], $params[2], $params[3]);
-                    }
-                } else {
-                    while (($i = array_shift($keys)) !== null) {
-                        $out[] = call_user_func_array($callback, array(1 => $items[$i]) + $params);
-                    }
-                }
-            } else {
-                $items = $params[0];
-                $keys  = array_keys($items);
-
-                if (is_string($callback) === false) {
-                    while (($i = array_shift($keys)) !== null) {
-                        $out[] = call_user_func_array($callback, array($items[$i]) + $params);
-                    }
-                } elseif ($cnt === 1) {
-                    while (($i = array_shift($keys)) !== null) {
-                        $out[] = $callback($items[$i]);
-                    }
-                } elseif ($cnt === 2) {
-                    while (($i = array_shift($keys)) !== null) {
-                        $out[] = $callback($items[$i], $params[1]);
-                    }
-                } elseif ($cnt === 3) {
-                    while (($i = array_shift($keys)) !== null) {
-                        $out[] = $callback($items[$i], $params[1], $params[2]);
-                    }
-                } elseif ($cnt === 4) {
-                    while (($i = array_shift($keys)) !== null) {
-                        $out[] = $callback($items[$i], $params[1], $params[2], $params[3]);
-                    }
-                } else {
-                    while (($i = array_shift($keys)) !== null) {
-                        $out[] = call_user_func_array($callback, array($items[$i]) + $params);
-                    }
-                }
-            }
-
-            return $out;
-        } else {
-            return $params[0];
-        }
-    }
-
-    /**
-     * Reads a variable into the given data array.
-     *
-     * @param string $varstr   the variable string, using dwoo variable syntax (i.e. "var.subvar[subsubvar]->property")
-     * @param mixed  $data     the data array or object to read from
-     * @param bool   $safeRead if true, the function will check whether the index exists to prevent any notices from
-     *                         being output
-     *
-     * @return mixed
-     */
-    public function readVarInto($varstr, $data, $safeRead = false)
-    {
-        if ($data === null) {
-            return null;
-        }
-
-        if (is_array($varstr) === false) {
-            preg_match_all('#(\[|->|\.)?((?:[^.[\]-]|-(?!>))+)\]?#i', $varstr, $m);
-        } else {
-            $m = $varstr;
-        }
-        unset($varstr);
-
-        while (list($k, $sep) = each($m[1])) {
-            if ($sep === '.' || $sep === '[' || $sep === '') {
-                // strip enclosing quotes if present
-                $m[2][$k] = preg_replace('#^(["\']?)(.*?)\1$#', '$2', $m[2][$k]);
-
-                if ((is_array($data) || $data instanceof ArrayAccess) && ($safeRead === false || isset($data[$m[2][$k]]))) {
-                    $data = $data[$m[2][$k]];
-                } else {
-                    return null;
-                }
-            } else {
-                if (is_object($data) && ($safeRead === false || isset($data->$m[2][$k]))) {
-                    $data = $data->$m[2][$k];
-                } else {
-                    return null;
-                }
-            }
-        }
-
-        return $data;
-    }
-
-    /**
-     * Reads a variable into the parent scope.
-     *
-     * @param int    $parentLevels the amount of parent levels to go from the current scope
-     * @param string $varstr       the variable string, using dwoo variable syntax (i.e.
-     *                             "var.subvar[subsubvar]->property")
-     *
-     * @return mixed
-     */
-    public function readParentVar($parentLevels, $varstr = null)
-    {
-        $tree = $this->scopeTree;
-        $cur  = $this->data;
-
-        while ($parentLevels -- !== 0) {
-            array_pop($tree);
-        }
-
-        while (($i = array_shift($tree)) !== null) {
-            if (is_object($cur)) {
-                $cur = $cur->$i;
-            } else {
-                $cur = $cur[$i];
-            }
-        }
-
-        if ($varstr !== null) {
-            return $this->readVarInto($varstr, $cur);
-        } else {
-            return $cur;
-        }
-    }
-
-    /**
-     * Reads a variable into the current scope.
-     *
-     * @param string $varstr the variable string, using dwoo variable syntax (i.e. "var.subvar[subsubvar]->property")
-     *
-     * @return mixed
-     */
-    public function readVar($varstr)
-    {
-        if (is_array($varstr) === true) {
-            $m = $varstr;
-            unset($varstr);
-        } else {
-            if (strstr($varstr, '.') === false && strstr($varstr, '[') === false && strstr($varstr, '->') === false) {
-                if ($varstr === 'dwoo') {
-                    return $this->globals;
-                } elseif ($varstr === '__' || $varstr === '_root') {
-                    return $this->data;
-                } elseif ($varstr === '_' || $varstr === '_parent') {
-                    $varstr = '.' . $varstr;
-                    $tree   = $this->scopeTree;
-                    $cur    = $this->data;
-                    array_pop($tree);
-
-                    while (($i = array_shift($tree)) !== null) {
-                        if (is_object($cur)) {
-                            $cur = $cur->$i;
-                        } else {
-                            $cur = $cur[$i];
-                        }
-                    }
-
-                    return $cur;
-                }
-
-                $cur = $this->scope;
-
-                if (isset($cur[$varstr])) {
-                    return $cur[$varstr];
-                } else {
-                    return null;
-                }
-            }
-
-            if (substr($varstr, 0, 1) === '.') {
-                $varstr = 'dwoo' . $varstr;
-            }
-
-            preg_match_all('#(\[|->|\.)?((?:[^.[\]-]|-(?!>))+)\]?#i', $varstr, $m);
-        }
-
-        $i = $m[2][0];
-        if ($i === 'dwoo') {
-            $cur = $this->globals;
-            array_shift($m[2]);
-            array_shift($m[1]);
-            switch ($m[2][0]) {
-            case 'get':
-                $cur = $_GET;
-                break;
-            case 'post':
-                $cur = $_POST;
-                break;
-            case 'session':
-                $cur = $_SESSION;
-                break;
-            case 'cookies':
-            case 'cookie':
-                $cur = $_COOKIE;
-                break;
-            case 'server':
-                $cur = $_SERVER;
-                break;
-            case 'env':
-                $cur = $_ENV;
-                break;
-            case 'request':
-                $cur = $_REQUEST;
-                break;
-            case 'const':
-                array_shift($m[2]);
-                if (defined($m[2][0])) {
-                    return constant($m[2][0]);
-                } else {
-                    return null;
-                }
-            }
-            if ($cur !== $this->globals) {
-                array_shift($m[2]);
-                array_shift($m[1]);
-            }
-        } elseif ($i === '__' || $i === '_root') {
-            $cur = $this->data;
-            array_shift($m[2]);
-            array_shift($m[1]);
-        } elseif ($i === '_' || $i === '_parent') {
-            $tree = $this->scopeTree;
-            $cur  = $this->data;
-
-            while (true) {
-                array_pop($tree);
-                array_shift($m[2]);
-                array_shift($m[1]);
-                if (current($m[2]) === '_' || current($m[2]) === '_parent') {
-                    continue;
-                }
-
-                while (($i = array_shift($tree)) !== null) {
-                    if (is_object($cur)) {
-                        $cur = $cur->$i;
-                    } else {
-                        $cur = $cur[$i];
-                    }
-                }
-                break;
-            }
-        } else {
-            $cur = $this->scope;
-        }
-
-        while (list($k, $sep) = each($m[1])) {
-            if ($sep === '.' || $sep === '[' || $sep === '') {
-                if ((is_array($cur) || $cur instanceof ArrayAccess) && isset($cur[$m[2][$k]])) {
-                    $cur = $cur[$m[2][$k]];
-                } else {
-                    return null;
-                }
-            } elseif ($sep === '->') {
-                if (is_object($cur)) {
-                    $cur = $cur->$m[2][$k];
-                } else {
-                    return null;
-                }
-            } else {
-                return null;
-            }
-        }
-
-        return $cur;
-    }
-
-    /**
-     * Assign the value to the given variable.
-     *
-     * @param mixed  $value the value to assign
-     * @param string $scope the variable string, using dwoo variable syntax (i.e. "var.subvar[subsubvar]->property")
-     *
-     * @return bool true if assigned correctly or false if a problem occured while parsing the var string
-     */
-    public function assignInScope($value, $scope)
-    {
-        if (!is_string($scope)) {
-            $this->triggerError('Assignments must be done into strings, (' . gettype($scope) . ') ' . var_export($scope, true) . ' given', E_USER_ERROR);
-        }
-        if (strstr($scope, '.') === false && strstr($scope, '->') === false) {
-            $this->scope[$scope] = $value;
-        } else {
-            // TODO handle _root/_parent scopes ?
-            preg_match_all('#(\[|->|\.)?([^.[\]-]+)\]?#i', $scope, $m);
-
-            $cur  = &$this->scope;
-            $last = array(
-                array_pop($m[1]),
-                array_pop($m[2])
-            );
-
-            while (list($k, $sep) = each($m[1])) {
-                if ($sep === '.' || $sep === '[' || $sep === '') {
-                    if (is_array($cur) === false) {
-                        $cur = array();
-                    }
-                    $cur = &$cur[$m[2][$k]];
-                } elseif ($sep === '->') {
-                    if (is_object($cur) === false) {
-                        $cur = new stdClass();
-                    }
-                    $cur = &$cur->$m[2][$k];
-                } else {
-                    return false;
-                }
-            }
-
-            if ($last[0] === '.' || $last[0] === '[' || $last[0] === '') {
-                if (is_array($cur) === false) {
-                    $cur = array();
-                }
-                $cur[$last[1]] = $value;
-            } elseif ($last[0] === '->') {
-                if (is_object($cur) === false) {
-                    $cur = new stdClass();
-                }
-                $cur->$last[1] = $value;
-            } else {
-                return false;
-            }
-        }
-    }
-
-    /**
-     * Sets the scope to the given scope string or array.
-     *
-     * @param mixed $scope    a string i.e. "level1.level2" or an array i.e. array("level1", "level2")
-     * @param bool  $absolute if true, the scope is set from the top level scope and not from the current scope
-     *
-     * @return array the current scope tree
-     */
-    public function setScope($scope, $absolute = false)
-    {
-        $old = $this->scopeTree;
-
-        if (is_string($scope) === true) {
-            $scope = explode('.', $scope);
-        }
-
-        if ($absolute === true) {
-            $this->scope     = &$this->data;
-            $this->scopeTree = array();
-        }
-
-        while (($bit = array_shift($scope)) !== null) {
-            if ($bit === '_' || $bit === '_parent') {
-                array_pop($this->scopeTree);
-                $this->scope = &$this->data;
-                $cnt         = count($this->scopeTree);
-                for ($i = 0; $i < $cnt; ++ $i) {
-                    $this->scope = &$this->scope[$this->scopeTree[$i]];
-                }
-            } elseif ($bit === '__' || $bit === '_root') {
-                $this->scope     = &$this->data;
-                $this->scopeTree = array();
-            } elseif (isset($this->scope[$bit])) {
-                if ($this->scope instanceof ArrayAccess) {
-                    $tmp         = $this->scope[$bit];
-                    $this->scope = &$tmp;
-                } else {
-                    $this->scope = &$this->scope[$bit];
-                }
-                $this->scopeTree[] = $bit;
-            } else {
-                unset($this->scope);
-                $this->scope = null;
-            }
-        }
-
-        return $old;
-    }
-
-    /**
-     * Returns the entire data array.
-     *
-     * @return array
-     */
-    public function getData()
-    {
-        return $this->data;
-    }
-
-    /**
-     * Sets a return value for the currently running template.
-     *
-     * @param string $name  var name
-     * @param mixed  $value var value
-     *
-     * @return void
-     */
-    public function setReturnValue($name, $value)
-    {
-        $this->returnData[$name] = $value;
-    }
-
-    /**
-     * Retrieves the return values set by the template.
-     *
-     * @return array
-     */
-    public function getReturnValues()
-    {
-        return $this->returnData;
-    }
-
-    /**
-     * Returns a reference to the current scope.
-     *
-     * @return mixed
-     */
-    public function &getScope()
-    {
-        return $this->scope;
-    }
-
-    /**
-     * Redirects all calls to unexisting to plugin proxy.
-     *
-     * @param string $method the method name
-     * @param array  $args   array of arguments
-     *
-     * @return mixed
-     * @throws Exception
-     */
-    public function __call($method, $args)
-    {
-        $proxy = $this->getPluginProxy();
-        if (!$proxy) {
-            throw new Exception('Call to undefined method ' . __CLASS__ . '::' . $method . '()');
-        }
-
-        return call_user_func_array($proxy->getCallback($method), $args);
-    }
-
-    /**
-     * Convert plugin name from `auto_escape` to `AutoEscape`.
-     * @param string $input
-     * @param string $separator
-     *
-     * @return mixed
-     */
-    public static function toCamelCase($input, $separator = '_')
-    {
-        return join(array_map('ucfirst', explode($separator, $input)));
-
-        // TODO >= PHP5.4.32
-        //return str_replace($separator, '', ucwords($input, $separator));
-    }
+				);
+			}
+
+			$this->filters[] = $callback;
+		} else {
+			$this->filters[] = $callback;
+		}
+	}
+
+	/**
+	 * Removes a filter.
+	 *
+	 * @param mixed $callback callback or filter name if it was autoloaded
+	 *
+	 * @return void
+	 */
+	public function removeFilter($callback)
+	{
+		if (($index = array_search(self::NAMESPACE_PLUGINS_FILTERS. 'Filter' . self::toCamelCase($callback), $this->filters,
+				true)) !==
+			false) {
+			unset($this->filters[$index]);
+		} elseif (($index = array_search($callback, $this->filters, true)) !== false) {
+			unset($this->filters[$index]);
+		} else {
+			$class = self::NAMESPACE_PLUGINS_FILTERS . 'Filter' . $callback;
+			foreach ($this->filters as $index => $filter) {
+				if (is_array($filter) && $filter[0] instanceof $class) {
+					unset($this->filters[$index]);
+					break;
+				}
+			}
+		}
+	}
+
+	/**
+	 * Adds a resource or overrides a default one.
+	 *
+	 * @param string   $name            the resource name
+	 * @param string   $class           the resource class (which must implement ITemplate)
+	 * @param callback $compilerFactory the compiler factory callback, a function that must return a compiler instance
+	 *                                  used to compile this resource, if none is provided. by default it will produce
+	 *                                  a Compiler object
+	 *
+	 * @return void
+	 * @throws Exception
+	 */
+	public function addResource($name, $class, $compilerFactory = null)
+	{
+		if (strlen($name) < 2) {
+			throw new Exception('Resource names must be at least two-character long to avoid conflicts with Windows paths');
+		}
+
+		if (!class_exists($class)) {
+			throw new Exception('Resource class does not exist');
+		}
+
+		$interfaces = class_implements($class);
+		if (in_array('Dwoo\ITemplate', $interfaces) === false) {
+			throw new Exception('Resource class must implement ITemplate');
+		}
+
+		$this->resources[$name] = array(
+			'class'    => $class,
+			'compiler' => $compilerFactory
+		);
+	}
+
+	/**
+	 * Removes a custom resource.
+	 *
+	 * @param string $name the resource name
+	 *
+	 * @return void
+	 */
+	public function removeResource($name)
+	{
+		unset($this->resources[$name]);
+		if ($name === 'file') {
+			$this->resources['file'] = array(
+				'class'    => 'Dwoo\Template\File',
+				'compiler' => null
+			);
+		}
+	}
+
+	/**
+	 * Sets the loader object to use to load plugins.
+	 *
+	 * @param ILoader $loader loader
+	 *
+	 * @return void
+	 */
+	public function setLoader(ILoader $loader)
+	{
+		$this->loader = $loader;
+	}
+
+	/**
+	 * Returns the current loader object or a default one if none is currently found.
+	 *
+	 * @return ILoader|Loader
+	 */
+	public function getLoader()
+	{
+		if ($this->loader === null) {
+			$this->loader = new Loader($this->getCompileDir());
+		}
+
+		return $this->loader;
+	}
+
+	/**
+	 * Returns the custom plugins loaded.
+	 * Used by the ITemplate classes to pass the custom plugins to their ICompiler instance.
+	 *
+	 * @return array
+	 */
+	public function getCustomPlugins()
+	{
+		return $this->plugins;
+	}
+
+	/**
+	 * Return a specified custom plugin loaded by his name.
+	 * Used by the compiler, for executing a Closure.
+	 *
+	 * @param string $name
+	 *
+	 * @return mixed|null
+	 */
+	public function getCustomPlugin($name)
+	{
+		if (isset($this->plugins[$name])) {
+			return $this->plugins[$name]['callback'];
+		}
+
+		return null;
+	}
+
+	/**
+	 * Returns the cache directory with a trailing DIRECTORY_SEPARATOR.
+	 *
+	 * @return string
+	 */
+	public function getCacheDir()
+	{
+		if ($this->cacheDir === null) {
+			$this->setCacheDir(dirname(__DIR__) . DIRECTORY_SEPARATOR . 'cache' . DIRECTORY_SEPARATOR);
+		}
+
+		return $this->cacheDir;
+	}
+
+	/**
+	 * Sets the cache directory and automatically appends a DIRECTORY_SEPARATOR.
+	 *
+	 * @param string $dir the cache directory
+	 *
+	 * @return void
+	 * @throws Exception
+	 */
+	public function setCacheDir($dir)
+	{
+		$this->cacheDir = rtrim($dir, '/\\') . DIRECTORY_SEPARATOR;
+		if (is_writable($this->cacheDir) === false) {
+			throw new Exception('The cache directory must be writable, chmod "' . $this->cacheDir . '" to make it writable');
+		}
+	}
+
+	/**
+	 * Returns the compile directory with a trailing DIRECTORY_SEPARATOR.
+	 *
+	 * @return string
+	 */
+	public function getCompileDir()
+	{
+		if ($this->compileDir === null) {
+			$this->setCompileDir(dirname(__DIR__) . DIRECTORY_SEPARATOR . 'compiled' . DIRECTORY_SEPARATOR);
+		}
+
+		return $this->compileDir;
+	}
+
+	/**
+	 * Sets the compile directory and automatically appends a DIRECTORY_SEPARATOR.
+	 *
+	 * @param string $dir the compile directory
+	 *
+	 * @return void
+	 * @throws Exception
+	 */
+	public function setCompileDir($dir)
+	{
+		$this->compileDir = rtrim($dir, '/\\') . DIRECTORY_SEPARATOR;
+		if (is_writable($this->compileDir) === false) {
+			throw new Exception('The compile directory must be writable, chmod "' . $this->compileDir . '" to make it writable');
+		}
+	}
+
+	/**
+	 * Returns the default cache time that is used with templates that do not have a cache time set.
+	 *
+	 * @return int the duration in seconds
+	 */
+	public function getCacheTime()
+	{
+		return $this->cacheTime;
+	}
+
+	/**
+	 * Sets the default cache time to use with templates that do not have a cache time set.
+	 *
+	 * @param int $seconds the duration in seconds
+	 *
+	 * @return void
+	 */
+	public function setCacheTime($seconds)
+	{
+		$this->cacheTime = (int)$seconds;
+	}
+
+	/**
+	 * Returns the character set used by the string manipulation plugins.
+	 * the charset is automatically lowercased
+	 *
+	 * @return string
+	 */
+	public function getCharset()
+	{
+		return $this->charset;
+	}
+
+	/**
+	 * Sets the character set used by the string manipulation plugins.
+	 * the charset will be automatically lowercased
+	 *
+	 * @param string $charset the character set
+	 *
+	 * @return void
+	 */
+	public function setCharset($charset)
+	{
+		$this->charset = strtolower((string)$charset);
+	}
+
+	/**
+	 * Returns the current template being rendered, when applicable, or null.
+	 *
+	 * @return ITemplate|null
+	 */
+	public function getTemplate()
+	{
+		return $this->template;
+	}
+
+	/**
+	 * Sets the current template being rendered.
+	 *
+	 * @param ITemplate $tpl template object
+	 *
+	 * @return void
+	 */
+	public function setTemplate(ITemplate $tpl)
+	{
+		$this->template = $tpl;
+	}
+
+	/**
+	 * Sets the default compiler factory function for the given resource name.
+	 * a compiler factory must return a ICompiler object pre-configured to fit your needs
+	 *
+	 * @param string   $resourceName    the resource name (i.e. file, string)
+	 * @param callback $compilerFactory the compiler factory callback
+	 *
+	 * @return void
+	 */
+	public function setDefaultCompilerFactory($resourceName, $compilerFactory)
+	{
+		$this->resources[$resourceName]['compiler'] = $compilerFactory;
+	}
+
+	/**
+	 * Returns the default compiler factory function for the given resource name.
+	 *
+	 * @param string $resourceName the resource name
+	 *
+	 * @return callback the compiler factory callback
+	 */
+	public function getDefaultCompilerFactory($resourceName)
+	{
+		return $this->resources[$resourceName]['compiler'];
+	}
+
+	/**
+	 * Sets the security policy object to enforce some php security settings.
+	 * use this if untrusted persons can modify templates
+	 *
+	 * @param SecurityPolicy $policy the security policy object
+	 *
+	 * @return void
+	 */
+	public function setSecurityPolicy(SecurityPolicy $policy = null)
+	{
+		$this->securityPolicy = $policy;
+	}
+
+	/**
+	 * Returns the current security policy object or null by default.
+	 *
+	 * @return SecurityPolicy|null the security policy object if any
+	 */
+	public function getSecurityPolicy()
+	{
+		return $this->securityPolicy;
+	}
+
+	/**
+	 * Sets the object that must be used as a plugin proxy when plugin can't be found
+	 * by dwoo's loader.
+	 *
+	 * @param IPluginProxy $pluginProxy the proxy object
+	 *
+	 * @return void
+	 */
+	public function setPluginProxy(IPluginProxy $pluginProxy)
+	{
+		$this->pluginProxy = $pluginProxy;
+	}
+
+	/**
+	 * Returns the current plugin proxy object or null by default.
+	 *
+	 * @return IPluginProxy
+	 */
+	public function getPluginProxy()
+	{
+		return $this->pluginProxy;
+	}
+
+	/**
+	 * Checks whether the given template is cached or not.
+	 *
+	 * @param ITemplate $tpl the template object
+	 *
+	 * @return bool
+	 */
+	public function isCached(ITemplate $tpl)
+	{
+		return is_string($tpl->getCachedTemplate($this));
+	}
+
+	/**
+	 * Clear templates inside the compiled directory.
+	 *
+	 * @return int
+	 */
+	public function clearCompiled()
+	{
+		$iterator = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($this->getCompileDir()), \RecursiveIteratorIterator::SELF_FIRST);
+		$count    = 0;
+		foreach ($iterator as $file) {
+			if ($file->isFile()) {
+				$count += unlink($file->__toString()) ? 1 : 0;
+			}
+		}
+
+		return $count;
+	}
+
+	/**
+	 * Clears the cached templates if they are older than the given time.
+	 *
+	 * @param int $olderThan minimum time (in seconds) required for a cached template to be cleared
+	 *
+	 * @return int the amount of templates cleared
+	 */
+	public function clearCache($olderThan = - 1)
+	{
+		$iterator = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($this->getCacheDir()), \RecursiveIteratorIterator::SELF_FIRST);
+		$expired  = time() - $olderThan;
+		$count    = 0;
+		foreach ($iterator as $file) {
+			if ($file->isFile() && $file->getCTime() < $expired) {
+				$count += unlink((string)$file) ? 1 : 0;
+			}
+		}
+
+		return $count;
+	}
+
+	/**
+	 * Fetches a template object of the given resource.
+	 *
+	 * @param string    $resourceName   the resource name (i.e. file, string)
+	 * @param string    $resourceId     the resource identifier (i.e. file path)
+	 * @param int       $cacheTime      the cache time setting for this resource
+	 * @param string    $cacheId        the unique cache identifier
+	 * @param string    $compileId      the unique compiler identifier
+	 * @param ITemplate $parentTemplate the parent template
+	 *
+	 * @return ITemplate
+	 * @throws Exception
+	 */
+	public function templateFactory($resourceName, $resourceId, $cacheTime = null, $cacheId = null, $compileId = null, ITemplate $parentTemplate = null)
+	{
+		if (isset($this->resources[$resourceName])) {
+			/**
+			 * Interface ITemplate
+			 *
+			 * @var ITemplate $class
+			 */
+			$class = $this->resources[$resourceName]['class'];
+
+			return $class::templateFactory($this, $resourceId, $cacheTime, $cacheId, $compileId, $parentTemplate);
+		}
+
+		throw new Exception('Unknown resource type : ' . $resourceName);
+	}
+
+	/**
+	 * Checks if the input is an array or arrayaccess object, optionally it can also check if it's
+	 * empty.
+	 *
+	 * @param mixed $value        the variable to check
+	 * @param bool  $checkIsEmpty if true, the function will also check if the array|arrayaccess is empty,
+	 *                            and return true only if it's not empty
+	 *
+	 * @return int|bool true if it's an array|arrayaccess (or the item count if $checkIsEmpty is true) or false if it's
+	 *                  not an array|arrayaccess (or 0 if $checkIsEmpty is true)
+	 */
+	public function isArray($value, $checkIsEmpty = false)
+	{
+		if (is_array($value) === true || $value instanceof ArrayAccess) {
+			if ($checkIsEmpty === false) {
+				return true;
+			}
+
+			return $this->count($value);
+		}
+
+		return false;
+	}
+
+	/**
+	 * Checks if the input is an array or a traversable object, optionally it can also check if it's
+	 * empty.
+	 *
+	 * @param mixed $value        the variable to check
+	 * @param bool  $checkIsEmpty if true, the function will also check if the array|traversable is empty,
+	 *                            and return true only if it's not empty
+	 *
+	 * @return int|bool true if it's an array|traversable (or the item count if $checkIsEmpty is true) or false if it's
+	 *                  not an array|traversable (or 0 if $checkIsEmpty is true)
+	 */
+	public function isTraversable($value, $checkIsEmpty = false)
+	{
+		if (is_array($value) === true) {
+			if ($checkIsEmpty === false) {
+				return true;
+			} else {
+				return count($value) > 0;
+			}
+		} elseif ($value instanceof Traversable) {
+			if ($checkIsEmpty === false) {
+				return true;
+			} else {
+				return $this->count($value);
+			}
+		}
+
+		return false;
+	}
+
+	/**
+	 * Counts an array or arrayaccess/traversable object.
+	 *
+	 * @param mixed $value the value to count
+	 *
+	 * @return int|bool the count for arrays and objects that implement countable, true for other objects that don't,
+	 *                  and 0 for empty elements
+	 */
+	public function count($value)
+	{
+		if (is_array($value) === true || $value instanceof Countable) {
+			return count($value);
+		} elseif ($value instanceof ArrayAccess) {
+			if ($value->offsetExists(0)) {
+				return true;
+			}
+		} elseif ($value instanceof Iterator) {
+			$value->rewind();
+			if ($value->valid()) {
+				return true;
+			}
+		} elseif ($value instanceof Traversable) {
+			foreach ($value as $dummy) {
+				return true;
+			}
+		}
+
+		return 0;
+	}
+
+	/**
+	 * Triggers a dwoo error.
+	 *
+	 * @param string $message the error message
+	 * @param int    $level   the error level, one of the PHP's E_* constants
+	 *
+	 * @return void
+	 */
+	public function triggerError($message, $level = E_USER_NOTICE)
+	{
+		if (!($tplIdentifier = $this->template->getResourceIdentifier())) {
+			$tplIdentifier = $this->template->getResourceName();
+		}
+		trigger_error('Dwoo error (in ' . $tplIdentifier . ') : ' . $message, $level);
+	}
+
+	/**
+	 * Adds a block to the block stack.
+	 *
+	 * @param string $blockName the block name (without Dwoo_Plugin_ prefix)
+	 * @param array  $args      the arguments to be passed to the block's init() function
+	 *
+	 * @return BlockPlugin the newly created block
+	 */
+	public function addStack($blockName, array $args = array())
+	{
+		if (isset($this->plugins[$blockName])) {
+			$class = $this->plugins[$blockName]['class'];
+		} else {
+			$class = self::NAMESPACE_PLUGINS_BLOCKS . 'Plugin' . self::toCamelCase($blockName);
+		}
+
+		if ($this->curBlock !== null) {
+			$this->curBlock->buffer(ob_get_contents());
+			ob_clean();
+		} else {
+			$this->buffer .= ob_get_contents();
+			ob_clean();
+		}
+
+		$block = new $class($this);
+
+		call_user_func_array(array($block, 'init'), $args);
+
+		$this->stack[] = $this->curBlock = $block;
+
+		return $block;
+	}
+
+	/**
+	 * Removes the plugin at the top of the block stack.
+	 * Calls the block buffer() function, followed by a call to end() and finally a call to process()
+	 *
+	 * @return void
+	 */
+	public function delStack()
+	{
+		$args = func_get_args();
+
+		$this->curBlock->buffer(ob_get_contents());
+		ob_clean();
+
+		call_user_func_array(array($this->curBlock, 'end'), $args);
+
+		$tmp = array_pop($this->stack);
+
+		if (count($this->stack) > 0) {
+			$this->curBlock = end($this->stack);
+			$this->curBlock->buffer($tmp->process());
+		} else {
+			if ($this->buffer !== '') {
+				echo $this->buffer;
+				$this->buffer = '';
+			}
+			$this->curBlock = null;
+			echo $tmp->process();
+		}
+
+		unset($tmp);
+	}
+
+	/**
+	 * Returns the parent block of the given block.
+	 *
+	 * @param BlockPlugin $block the block class plugin
+	 *
+	 * @return BlockPlugin|false if the given block isn't in the stack
+	 */
+	public function getParentBlock(BlockPlugin $block)
+	{
+		$index = array_search($block, $this->stack, true);
+		if ($index !== false && $index > 0) {
+			return $this->stack[$index - 1];
+		}
+
+		return false;
+	}
+
+	/**
+	 * Finds the closest block of the given type, starting at the top of the stack.
+	 *
+	 * @param string $type the type of plugin you want to find
+	 *
+	 * @return BlockPlugin|false if no plugin of such type is in the stack
+	 */
+	public function findBlock($type)
+	{
+		if (isset($this->plugins[$type])) {
+			$type = $this->plugins[$type]['class'];
+		} else {
+			$type = self::NAMESPACE_PLUGINS_BLOCKS . 'Plugin_' . str_replace(self::NAMESPACE_PLUGINS_BLOCKS.'Plugin',
+					'', $type);
+		}
+
+		$keys = array_keys($this->stack);
+		while (($key = array_pop($keys)) !== false) {
+			if ($this->stack[$key] instanceof $type) {
+				return $this->stack[$key];
+			}
+		}
+
+		return false;
+	}
+
+	/**
+	 * Returns a Plugin of the given class.
+	 * this is so a single instance of every class plugin is created at each template run,
+	 * allowing class plugins to have "per-template-run" static variables
+	 *
+	 * @param string $class the class name
+	 *
+	 * @return mixed an object of the given class
+	 */
+	public function getObjectPlugin($class)
+	{
+		if (isset($this->runtimePlugins[$class])) {
+			return $this->runtimePlugins[$class];
+		}
+
+		return $this->runtimePlugins[$class] = new $class($this);
+	}
+
+	/**
+	 * Calls the process() method of the given class-plugin name.
+	 *
+	 * @param string $plugName the class plugin name (without Dwoo_Plugin_ prefix)
+	 * @param array  $params   an array of parameters to send to the process() method
+	 *
+	 * @return string the process() return value
+	 */
+	public function classCall($plugName, array $params = array())
+	{
+		$class  = self::toCamelCase($plugName);
+		$plugin = $this->getObjectPlugin($class);
+
+		return call_user_func_array(array($plugin, 'process'), $params);
+	}
+
+	/**
+	 * Calls a php function.
+	 *
+	 * @param string $callback the function to call
+	 * @param array  $params   an array of parameters to send to the function
+	 *
+	 * @return mixed the return value of the called function
+	 */
+	public function arrayMap($callback, array $params)
+	{
+		if ($params[0] === $this) {
+			$addThis = true;
+			array_shift($params);
+		}
+		if ((is_array($params[0]) || ($params[0] instanceof Iterator && $params[0] instanceof ArrayAccess))) {
+			if (empty($params[0])) {
+				return $params[0];
+			}
+
+			// array map
+			$out = array();
+			$cnt = count($params);
+
+			if (isset($addThis)) {
+				array_unshift($params, $this);
+				$items = $params[1];
+				$keys  = array_keys($items);
+
+				if (is_string($callback) === false) {
+					while (($i = array_shift($keys)) !== null) {
+						$out[] = call_user_func_array($callback, array(1 => $items[$i]) + $params);
+					}
+				} elseif ($cnt === 1) {
+					while (($i = array_shift($keys)) !== null) {
+						$out[] = $callback($this, $items[$i]);
+					}
+				} elseif ($cnt === 2) {
+					while (($i = array_shift($keys)) !== null) {
+						$out[] = $callback($this, $items[$i], $params[2]);
+					}
+				} elseif ($cnt === 3) {
+					while (($i = array_shift($keys)) !== null) {
+						$out[] = $callback($this, $items[$i], $params[2], $params[3]);
+					}
+				} else {
+					while (($i = array_shift($keys)) !== null) {
+						$out[] = call_user_func_array($callback, array(1 => $items[$i]) + $params);
+					}
+				}
+			} else {
+				$items = $params[0];
+				$keys  = array_keys($items);
+
+				if (is_string($callback) === false) {
+					while (($i = array_shift($keys)) !== null) {
+						$out[] = call_user_func_array($callback, array($items[$i]) + $params);
+					}
+				} elseif ($cnt === 1) {
+					while (($i = array_shift($keys)) !== null) {
+						$out[] = $callback($items[$i]);
+					}
+				} elseif ($cnt === 2) {
+					while (($i = array_shift($keys)) !== null) {
+						$out[] = $callback($items[$i], $params[1]);
+					}
+				} elseif ($cnt === 3) {
+					while (($i = array_shift($keys)) !== null) {
+						$out[] = $callback($items[$i], $params[1], $params[2]);
+					}
+				} elseif ($cnt === 4) {
+					while (($i = array_shift($keys)) !== null) {
+						$out[] = $callback($items[$i], $params[1], $params[2], $params[3]);
+					}
+				} else {
+					while (($i = array_shift($keys)) !== null) {
+						$out[] = call_user_func_array($callback, array($items[$i]) + $params);
+					}
+				}
+			}
+
+			return $out;
+		} else {
+			return $params[0];
+		}
+	}
+
+	/**
+	 * Reads a variable into the given data array.
+	 *
+	 * @param string $varstr   the variable string, using dwoo variable syntax (i.e. "var.subvar[subsubvar]->property")
+	 * @param mixed  $data     the data array or object to read from
+	 * @param bool   $safeRead if true, the function will check whether the index exists to prevent any notices from
+	 *                         being output
+	 *
+	 * @return mixed
+	 */
+	public function readVarInto($varstr, $data, $safeRead = false)
+	{
+		if ($data === null) {
+			return null;
+		}
+
+		if (is_array($varstr) === false) {
+			preg_match_all('#(\[|->|\.)?((?:[^.[\]-]|-(?!>))+)\]?#i', $varstr, $m);
+		} else {
+			$m = $varstr;
+		}
+		unset($varstr);
+
+		while (list($k, $sep) = each($m[1])) {
+			if ($sep === '.' || $sep === '[' || $sep === '') {
+				// strip enclosing quotes if present
+				$m[2][$k] = preg_replace('#^(["\']?)(.*?)\1$#', '$2', $m[2][$k]);
+
+				if ((is_array($data) || $data instanceof ArrayAccess) && ($safeRead === false || isset($data[$m[2][$k]]))) {
+					$data = $data[$m[2][$k]];
+				} else {
+					return null;
+				}
+			} else {
+				if (is_object($data) && ($safeRead === false || isset($data->$m[2][$k]))) {
+					$data = $data->$m[2][$k];
+				} else {
+					return null;
+				}
+			}
+		}
+
+		return $data;
+	}
+
+	/**
+	 * Reads a variable into the parent scope.
+	 *
+	 * @param int    $parentLevels the amount of parent levels to go from the current scope
+	 * @param string $varstr       the variable string, using dwoo variable syntax (i.e.
+	 *                             "var.subvar[subsubvar]->property")
+	 *
+	 * @return mixed
+	 */
+	public function readParentVar($parentLevels, $varstr = null)
+	{
+		$tree = $this->scopeTree;
+		$cur  = $this->data;
+
+		while ($parentLevels -- !== 0) {
+			array_pop($tree);
+		}
+
+		while (($i = array_shift($tree)) !== null) {
+			if (is_object($cur)) {
+				$cur = $cur->$i;
+			} else {
+				$cur = $cur[$i];
+			}
+		}
+
+		if ($varstr !== null) {
+			return $this->readVarInto($varstr, $cur);
+		} else {
+			return $cur;
+		}
+	}
+
+	/**
+	 * Reads a variable into the current scope.
+	 *
+	 * @param string $varstr the variable string, using dwoo variable syntax (i.e. "var.subvar[subsubvar]->property")
+	 *
+	 * @return mixed
+	 */
+	public function readVar($varstr)
+	{
+		if (is_array($varstr) === true) {
+			$m = $varstr;
+			unset($varstr);
+		} else {
+			if (strstr($varstr, '.') === false && strstr($varstr, '[') === false && strstr($varstr, '->') === false) {
+				if ($varstr === 'dwoo') {
+					return $this->globals;
+				} elseif ($varstr === '__' || $varstr === '_root') {
+					return $this->data;
+				} elseif ($varstr === '_' || $varstr === '_parent') {
+					$varstr = '.' . $varstr;
+					$tree   = $this->scopeTree;
+					$cur    = $this->data;
+					array_pop($tree);
+
+					while (($i = array_shift($tree)) !== null) {
+						if (is_object($cur)) {
+							$cur = $cur->$i;
+						} else {
+							$cur = $cur[$i];
+						}
+					}
+
+					return $cur;
+				}
+
+				$cur = $this->scope;
+
+				if (isset($cur[$varstr])) {
+					return $cur[$varstr];
+				} else {
+					return null;
+				}
+			}
+
+			if (substr($varstr, 0, 1) === '.') {
+				$varstr = 'dwoo' . $varstr;
+			}
+
+			preg_match_all('#(\[|->|\.)?((?:[^.[\]-]|-(?!>))+)\]?#i', $varstr, $m);
+		}
+
+		$i = $m[2][0];
+		if ($i === 'dwoo') {
+			$cur = $this->globals;
+			array_shift($m[2]);
+			array_shift($m[1]);
+			switch ($m[2][0]) {
+			case 'get':
+				$cur = $_GET;
+				break;
+			case 'post':
+				$cur = $_POST;
+				break;
+			case 'session':
+				$cur = $_SESSION;
+				break;
+			case 'cookies':
+			case 'cookie':
+				$cur = $_COOKIE;
+				break;
+			case 'server':
+				$cur = $_SERVER;
+				break;
+			case 'env':
+				$cur = $_ENV;
+				break;
+			case 'request':
+				$cur = $_REQUEST;
+				break;
+			case 'const':
+				array_shift($m[2]);
+				if (defined($m[2][0])) {
+					return constant($m[2][0]);
+				} else {
+					return null;
+				}
+			}
+			if ($cur !== $this->globals) {
+				array_shift($m[2]);
+				array_shift($m[1]);
+			}
+		} elseif ($i === '__' || $i === '_root') {
+			$cur = $this->data;
+			array_shift($m[2]);
+			array_shift($m[1]);
+		} elseif ($i === '_' || $i === '_parent') {
+			$tree = $this->scopeTree;
+			$cur  = $this->data;
+
+			while (true) {
+				array_pop($tree);
+				array_shift($m[2]);
+				array_shift($m[1]);
+				if (current($m[2]) === '_' || current($m[2]) === '_parent') {
+					continue;
+				}
+
+				while (($i = array_shift($tree)) !== null) {
+					if (is_object($cur)) {
+						$cur = $cur->$i;
+					} else {
+						$cur = $cur[$i];
+					}
+				}
+				break;
+			}
+		} else {
+			$cur = $this->scope;
+		}
+
+		while (list($k, $sep) = each($m[1])) {
+			if ($sep === '.' || $sep === '[' || $sep === '') {
+				if ((is_array($cur) || $cur instanceof ArrayAccess) && isset($cur[$m[2][$k]])) {
+					$cur = $cur[$m[2][$k]];
+				} else {
+					return null;
+				}
+			} elseif ($sep === '->') {
+				if (is_object($cur)) {
+					$cur = $cur->$m[2][$k];
+				} else {
+					return null;
+				}
+			} else {
+				return null;
+			}
+		}
+
+		return $cur;
+	}
+
+	/**
+	 * Assign the value to the given variable.
+	 *
+	 * @param mixed  $value the value to assign
+	 * @param string $scope the variable string, using dwoo variable syntax (i.e. "var.subvar[subsubvar]->property")
+	 *
+	 * @return bool true if assigned correctly or false if a problem occured while parsing the var string
+	 */
+	public function assignInScope($value, $scope)
+	{
+		if (!is_string($scope)) {
+			$this->triggerError('Assignments must be done into strings, (' . gettype($scope) . ') ' . var_export($scope, true) . ' given', E_USER_ERROR);
+		}
+		if (strstr($scope, '.') === false && strstr($scope, '->') === false) {
+			$this->scope[$scope] = $value;
+		} else {
+			// TODO handle _root/_parent scopes ?
+			preg_match_all('#(\[|->|\.)?([^.[\]-]+)\]?#i', $scope, $m);
+
+			$cur  = &$this->scope;
+			$last = array(
+				array_pop($m[1]),
+				array_pop($m[2])
+			);
+
+			while (list($k, $sep) = each($m[1])) {
+				if ($sep === '.' || $sep === '[' || $sep === '') {
+					if (is_array($cur) === false) {
+						$cur = array();
+					}
+					$cur = &$cur[$m[2][$k]];
+				} elseif ($sep === '->') {
+					if (is_object($cur) === false) {
+						$cur = new stdClass();
+					}
+					$cur = &$cur->$m[2][$k];
+				} else {
+					return false;
+				}
+			}
+
+			if ($last[0] === '.' || $last[0] === '[' || $last[0] === '') {
+				if (is_array($cur) === false) {
+					$cur = array();
+				}
+				$cur[$last[1]] = $value;
+			} elseif ($last[0] === '->') {
+				if (is_object($cur) === false) {
+					$cur = new stdClass();
+				}
+				$cur->$last[1] = $value;
+			} else {
+				return false;
+			}
+		}
+	}
+
+	/**
+	 * Sets the scope to the given scope string or array.
+	 *
+	 * @param mixed $scope    a string i.e. "level1.level2" or an array i.e. array("level1", "level2")
+	 * @param bool  $absolute if true, the scope is set from the top level scope and not from the current scope
+	 *
+	 * @return array the current scope tree
+	 */
+	public function setScope($scope, $absolute = false)
+	{
+		$old = $this->scopeTree;
+
+		if (is_string($scope) === true) {
+			$scope = explode('.', $scope);
+		}
+
+		if ($absolute === true) {
+			$this->scope     = &$this->data;
+			$this->scopeTree = array();
+		}
+
+		while (($bit = array_shift($scope)) !== null) {
+			if ($bit === '_' || $bit === '_parent') {
+				array_pop($this->scopeTree);
+				$this->scope = &$this->data;
+				$cnt         = count($this->scopeTree);
+				for ($i = 0; $i < $cnt; ++ $i) {
+					$this->scope = &$this->scope[$this->scopeTree[$i]];
+				}
+			} elseif ($bit === '__' || $bit === '_root') {
+				$this->scope     = &$this->data;
+				$this->scopeTree = array();
+			} elseif (isset($this->scope[$bit])) {
+				if ($this->scope instanceof ArrayAccess) {
+					$tmp         = $this->scope[$bit];
+					$this->scope = &$tmp;
+				} else {
+					$this->scope = &$this->scope[$bit];
+				}
+				$this->scopeTree[] = $bit;
+			} else {
+				unset($this->scope);
+				$this->scope = null;
+			}
+		}
+
+		return $old;
+	}
+
+	/**
+	 * Returns the entire data array.
+	 *
+	 * @return array
+	 */
+	public function getData()
+	{
+		return $this->data;
+	}
+
+	/**
+	 * Sets a return value for the currently running template.
+	 *
+	 * @param string $name  var name
+	 * @param mixed  $value var value
+	 *
+	 * @return void
+	 */
+	public function setReturnValue($name, $value)
+	{
+		$this->returnData[$name] = $value;
+	}
+
+	/**
+	 * Retrieves the return values set by the template.
+	 *
+	 * @return array
+	 */
+	public function getReturnValues()
+	{
+		return $this->returnData;
+	}
+
+	/**
+	 * Returns a reference to the current scope.
+	 *
+	 * @return mixed
+	 */
+	public function &getScope()
+	{
+		return $this->scope;
+	}
+
+	/**
+	 * Redirects all calls to unexisting to plugin proxy.
+	 *
+	 * @param string $method the method name
+	 * @param array  $args   array of arguments
+	 *
+	 * @return mixed
+	 * @throws Exception
+	 */
+	public function __call($method, $args)
+	{
+		$proxy = $this->getPluginProxy();
+		if (!$proxy) {
+			throw new Exception('Call to undefined method ' . __CLASS__ . '::' . $method . '()');
+		}
+
+		return call_user_func_array($proxy->getCallback($method), $args);
+	}
+
+	/**
+	 * Convert plugin name from `auto_escape` to `AutoEscape`.
+	 * @param string $input
+	 * @param string $separator
+	 *
+	 * @return mixed
+	 */
+	public static function toCamelCase($input, $separator = '_')
+	{
+		return join(array_map('ucfirst', explode($separator, $input)));
+
+		// TODO >= PHP5.4.32
+		//return str_replace($separator, '', ucwords($input, $separator));
+	}
 }