* PHPTAL library

1 files changed, 185 insertions, 0 deletions

diff --git a/lib/phptal/PHPTAL/TalesRegistry.php b/lib/phptal/PHPTAL/TalesRegistry.php
new file mode 100644
index 0000000..f519a1a
--- /dev/null
+++ b/lib/phptal/PHPTAL/TalesRegistry.php
@@ -0,0 +1,185 @@
+<?php
+/**
+ * PHPTAL templating engine
+ *
+ * PHP Version 5
+ *
+ * @category HTML
+ * @package  PHPTAL
+ * @author   Laurent Bedubourg <lbedubourg@motion-twin.com>
+ * @author   Kornel Lesiński <kornel@aardvarkmedia.co.uk>
+ * @license  http://www.gnu.org/licenses/lgpl.html GNU Lesser General Public License
+ * @version  SVN: $Id$
+ * @link     http://phptal.org/
+ */
+
+/**
+ * Global registry of TALES expression modifiers
+ *
+ * @package PHPTAL
+ * @subpackage Php
+ */
+class PHPTAL_TalesRegistry
+{
+    private static $instance;
+
+    /**
+     * This is a singleton
+     *
+     * @return PHPTAL_TalesRegistry
+     */
+    static public function getInstance()
+    {
+        if (!self::$instance) {
+            self::$instance = new PHPTAL_TalesRegistry();
+        }
+
+        return self::$instance;
+    }
+
+    protected function __construct()
+    {
+        $this->registerPrefix('not', array('PHPTAL_Php_TalesInternal', 'not'));
+        $this->registerPrefix('path', array('PHPTAL_Php_TalesInternal', 'path'));
+        $this->registerPrefix('string', array('PHPTAL_Php_TalesInternal', 'string'));
+        $this->registerPrefix('php', array('PHPTAL_Php_TalesInternal', 'php'));
+        $this->registerPrefix('phptal-internal-php-block', array('PHPTAL_Php_TalesInternal', 'phptal_internal_php_block'));
+        $this->registerPrefix('exists', array('PHPTAL_Php_TalesInternal', 'exists'));
+        $this->registerPrefix('number', array('PHPTAL_Php_TalesInternal', 'number'));
+        $this->registerPrefix('true', array('PHPTAL_Php_TalesInternal', 'true'));
+
+        // these are added as fallbacks
+        $this->registerPrefix('json', array('PHPTAL_Php_TalesInternal', 'json'), true);
+        $this->registerPrefix('urlencode', array('PHPTAL_Php_TalesInternal', 'urlencode'), true);
+    }
+
+    /**
+     * Unregisters a expression modifier
+     *
+     * @param string $prefix
+     *
+     * @throws PHPTAL_ConfigurationException
+     */
+    public function unregisterPrefix($prefix)
+    {
+        if (!$this->isRegistered($prefix)) {
+            throw new PHPTAL_ConfigurationException("Expression modifier '$prefix' is not registered");
+        }
+
+        unset($this->_callbacks[$prefix]);
+    }
+
+    /**
+     *
+     * Expects an either a function name or an array of class and method as
+     * callback.
+     *
+     * @param string $prefix
+     * @param mixed $callback
+     * @param bool $is_fallback if true, method will be used as last resort (if there's no phptal_tales_foo)
+     */
+    public function registerPrefix($prefix, $callback, $is_fallback = false)
+    {
+        if ($this->isRegistered($prefix) && !$this->_callbacks[$prefix]['is_fallback']) {
+            if ($is_fallback) {
+                return; // simply ignored
+            }
+            throw new PHPTAL_ConfigurationException("Expression modifier '$prefix' is already registered");
+        }
+
+        // Check if valid callback
+
+        if (is_array($callback)) {
+
+            $class = new ReflectionClass($callback[0]);
+
+            if (!$class->isSubclassOf('PHPTAL_Tales')) {
+                throw new PHPTAL_ConfigurationException('The class you want to register does not implement "PHPTAL_Tales".');
+            }
+
+            $method = new ReflectionMethod($callback[0], $callback[1]);
+
+            if (!$method->isStatic()) {
+                throw new PHPTAL_ConfigurationException('The method you want to register is not static.');
+            }
+
+            // maybe we want to check the parameters the method takes
+
+        } else {
+            if (!function_exists($callback)) {
+                throw new PHPTAL_ConfigurationException('The function you are trying to register does not exist.');
+            }
+        }
+
+        $this->_callbacks[$prefix] = array('callback'=>$callback, 'is_fallback'=>$is_fallback);
+    }
+
+    /**
+     * true if given prefix is taken
+     */
+    public function isRegistered($prefix)
+    {
+        if (array_key_exists($prefix, $this->_callbacks)) {
+            return true;
+        }
+    }
+
+    private function findUnregisteredCallback($typePrefix)
+    {
+        // class method
+        if (strpos($typePrefix, '.')) {
+            $classCallback = explode('.', $typePrefix, 2);
+            $callbackName  = null;
+            if (!is_callable($classCallback, false, $callbackName)) {
+                throw new PHPTAL_UnknownModifierException("Unknown phptal modifier $typePrefix. Function $callbackName does not exists or is not statically callable", $typePrefix);
+            }
+            $ref = new ReflectionClass($classCallback[0]);
+            if (!$ref->implementsInterface('PHPTAL_Tales')) {
+                throw new PHPTAL_UnknownModifierException("Unable to use phptal modifier $typePrefix as the class $callbackName does not implement the PHPTAL_Tales interface", $typePrefix);
+            }
+            return $classCallback;
+        }
+
+        // check if it is implemented via code-generating function
+        $func = 'phptal_tales_'.str_replace('-', '_', $typePrefix);
+        if (function_exists($func)) {
+            return $func;
+        }
+
+        // The following code is automatically modified in version for PHP 5.3
+        $func = 'PHPTALNAMESPACE\\phptal_tales_'.str_replace('-', '_', $typePrefix);
+        if (function_exists($func)) {
+            return $func;
+        }
+
+        return null;
+    }
+
+    /**
+     * get callback for the prefix
+     *
+     * @return callback or NULL
+     */
+    public function getCallback($prefix)
+    {
+        if ($this->isRegistered($prefix) && !$this->_callbacks[$prefix]['is_fallback']) {
+            return $this->_callbacks[$prefix]['callback'];
+        }
+
+        if ($callback = $this->findUnregisteredCallback($prefix)) {
+            return $callback;
+        }
+
+        if ($this->isRegistered($prefix)) {
+            return $this->_callbacks[$prefix]['callback'];
+        }
+
+        return null;
+    }
+
+    /**
+     * {callback, bool is_fallback}
+     */
+    private $_callbacks = array();
+}
+