[1.7.0] Add missing functions for DefinitionCache: replace, flush and type-checking

- Add version to configuration object, and have update script change it accordingly

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

library/HTMLPurifier/Config.php

@@ -23,6 +23,11 @@ require_once 'HTMLPurifier/DefinitionCache.php';
 class HTMLPurifier_Config
 {
     
+    /**
+     * HTML Purifier's version
+     */
+    var $version = '1.6.1';
+    
     /**
      * Two-level associative array of configuration directives
      */

library/HTMLPurifier/DefinitionCache.php

@@ -6,8 +6,6 @@ require_once 'HTMLPurifier/DefinitionCache/Serializer.php';
  * Abstract class representing Definition cache managers that implements
  * useful common methods and is a factory.
  * @note The configuration object is transformed into the key used by the cache
- * @todo Implement flush()
- * @todo Implement replace()
  * @todo Get some sort of versioning variable so the library can easily
  *       invalidate the cache with a new version
  * @todo Make the test runner cache aware and allow the user to easily
@@ -16,7 +14,6 @@ require_once 'HTMLPurifier/DefinitionCache/Serializer.php';
  *       cache their custom HTMLDefinition, which can be loaded
  *       via a configuration directive
  * @todo Implement memcached
- * @todo Perform type checking on $def objects
  */
 class HTMLPurifier_DefinitionCache
 {
@@ -50,6 +47,20 @@ class HTMLPurifier_DefinitionCache
         return new HTMLPurifier_DefinitionCache_Serializer($name);
     }
     
+    /**
+     * Checks if a definition's type jives with the cache's type
+     * @note Throws an error on failure
+     * @param $def Definition object to check
+     * @return Boolean true if good, false if not
+     */
+    function checkDefType($def) {
+        if ($def->type !== $this->type) {
+            trigger_error("Cannot use definition of type {$def->type} in cache for {$this->type}");
+            return false;
+        }
+        return true;
+    }
+    
     /**
      * Adds a definition object to the cache
      */
@@ -64,6 +75,13 @@ class HTMLPurifier_DefinitionCache
         trigger_error('Cannot call abstract method', E_USER_ERROR);
     }
     
+    /**
+     * Replace an object in the cache
+     */
+    function replace($def, $config) {
+        trigger_error('Cannot call abstract method', E_USER_ERROR);
+    }
+    
     /**
      * Retrieves a definition object from the cache
      */
@@ -78,6 +96,13 @@ class HTMLPurifier_DefinitionCache
         trigger_error('Cannot call abstract method', E_USER_ERROR);
     }
     
+    /**
+     * Clears all objects from cache
+     */
+    function flush($config) {
+        trigger_error('Cannot call abstract method', E_USER_ERROR);
+    }
+    
 }
 
 ?>

library/HTMLPurifier/DefinitionCache/Serializer.php

@@ -7,16 +7,25 @@ class HTMLPurifier_DefinitionCache_Serializer extends
 {
     
     function add($def, $config) {
+        if (!$this->checkDefType($def)) return;
         $file = $this->generateFilePath($config);
         if (file_exists($file)) return false;
         return $this->_write($file, serialize($def));
     }
     
     function set($def, $config) {
+        if (!$this->checkDefType($def)) return;
         $file = $this->generateFilePath($config);
         return $this->_write($file, serialize($def));
     }
     
+    function replace($def, $config) {
+        if (!$this->checkDefType($def)) return;
+        $file = $this->generateFilePath($config);
+        if (!file_exists($file)) return false;
+        return $this->_write($file, serialize($def));
+    }
+    
     function get($config) {
         $file = $this->generateFilePath($config);
         if (!file_exists($file)) return false;
@@ -29,13 +38,34 @@ class HTMLPurifier_DefinitionCache_Serializer extends
         return unlink($file);
     }
     
+    function flush() {
+        $dir = $this->generateDirectoryPath();
+        $dh  = opendir($dir);
+        while (false !== ($filename = readdir($dh))) {
+            if (empty($filename)) continue;
+            if ($filename[0] === '.') continue;
+            // optimization: md5 + .ser will always be 36 char long
+            // needs to be changed if we change the identifier
+            if (strlen($filename) !== 36) continue;
+            unlink($dir . '/' . $filename);
+        }
+    }
+    
     /**
      * Generates the file path to the serial file corresponding to
      * the configuration and definition name
      */
     function generateFilePath($config) {
         $key = $this->generateKey($config);
-        return dirname(__FILE__) . '/Serializer/' . $this->type . '/' . $key . '.ser';
+        return $this->generateDirectoryPath() . '/' . $key . '.ser';
+    }
+    
+    /**
+     * Generates the path to the directory contain this cache's serial files
+     * @note No trailing slash
+     */
+    function generateDirectoryPath() {
+        return dirname(__FILE__) . '/Serializer/' . $this->type;
     }
     
     /**