[1.7.0] Implement DoctypeRegistry. Add transparent constructor to Doctype.

git-svn-id: http://htmlpurifier.org/svnroot/htmlpurifier/trunk@1059 48356398-32a2-884e-a903-53898d9a118a

library/HTMLPurifier/Doctype.php

@@ -11,11 +11,6 @@ class HTMLPurifier_Doctype
      */
     var $name;
     
-    /**
-     * List of aliases to doctype name
-     */
-    var $aliases = array();
-    
     /**
      * List of standard modules (string identifiers or literal objects)
      * that this doctype uses
@@ -28,6 +23,20 @@ class HTMLPurifier_Doctype
      * is enabled, such as lenient or correctional.
      */
     var $modulesForModes = array();
+    
+    /**
+     * List of aliases to doctype name
+     */
+    var $aliases = array();
+    
+    function HTMLPurifier_Doctype($name = null, $modules = array(),
+        $modules_for_modes = array(), $aliases = array()
+    ) {
+        $this->name = $name;
+        $this->modules = $modules;
+        $this->modulesForModes = $modules_for_modes;
+        $this->aliases = $aliases;
+    }
 }
 
 ?>

library/HTMLPurifier/DoctypeRegistry.php

@@ -0,0 +1,69 @@
+<?php
+
+require_once 'HTMLPurifier/Doctype.php';
+
+class HTMLPurifier_DoctypeRegistry
+{
+    
+    /**
+     * Hash of doctype names to doctype objects
+     * @protected
+     */
+    var $doctypes;
+    
+    /**
+     * Lookup table of aliases to real doctype names
+     * @protected
+     */
+    var $aliases;
+    
+    /**
+     * Registers a doctype to the registry
+     * @note Accepts a fully-formed doctype object, or the
+     *       parameters for constructing a doctype object
+     * @param $doctype Name of doctype or literal doctype object
+     * @param $modules Modules doctype will load
+     * @param $modules_for_modes Modules doctype will load for certain modes
+     * @param $aliases Alias names for doctype
+     * @return Reference to registered doctype (usable for further editing)
+     */
+    function &register($doctype, $modules = array(),
+        $modules_for_modes = array(), $aliases = array()
+    ) {
+        if (!is_array($modules)) $modules = array($modules);
+        if (!is_array($aliases)) $aliases = array($aliases);
+        if (!is_object($doctype)) {
+            $doctype = new HTMLPurifier_Doctype(
+                $doctype, $modules, $modules_for_modes, $aliases
+            );
+        }
+        $this->doctypes[$doctype->name] =& $doctype;
+        $name = $doctype->name;
+        // hookup aliases
+        foreach ($doctype->aliases as $alias) {
+            if (isset($this->doctypes[$alias])) continue;
+            $this->aliases[$alias] = $name;
+        }
+        // remove old aliases
+        if (isset($this->aliases[$name])) unset($this->aliases[$name]);
+        return $doctype;
+    }
+    
+    /**
+     * Retrieves reference to a doctype of a certain name
+     * @note This function resolves aliases
+     * @param $doctype Name of doctype
+     * @return Reference to doctype object
+     */
+    function &get($doctype) {
+        if (isset($this->aliases[$doctype])) $doctype = $this->aliases[$doctype];
+        if (!isset($this->doctypes[$doctype])) {
+            trigger_error('Doctype ' . htmlspecialchars($doctype) . ' does not exist');
+            $null = null; return $null;
+        }
+        return $this->doctypes[$doctype];
+    }
+    
+}
+
+?>