lib/htmlpurifier/HTMLPurifier/EntityLookup.php

   1 <?php
   2
   3 /**
   4  * Object that provides entity lookup table from entity name to character
   5  */
   6 class HTMLPurifier_EntityLookup {
   7
   8     /**
   9      * Assoc array of entity name to character represented.
  10      * @public
  11      */
  12     var $table;
  13
  14     /**
  15      * Sets up the entity lookup table from the serialized file contents.
  16      * @note The serialized contents are versioned, but were generated
  17      *       using the maintenance script generate_entity_file.php
  18      * @warning This is not in constructor to help enforce the Singleton
  19      */
  20     function setup($file = false) {
  21         if (!$file) {
  22             $file = HTMLPURIFIER_PREFIX . '/HTMLPurifier/EntityLookup/entities.ser';
  23         }
  24         $this->table = unserialize(file_get_contents($file));
  25     }
  26
  27     /**
  28      * Retrieves sole instance of the object.
  29      * @static
  30      * @param Optional prototype of custom lookup table to overload with.
  31      */
  32     function instance($prototype = false) {
  33         // no references, since PHP doesn't copy unless modified
  34         static $instance = null;
  35         if ($prototype) {
  36             $instance = $prototype;
  37         } elseif (!$instance) {
  38             $instance = new HTMLPurifier_EntityLookup();
  39             $instance->setup();
  40         }
  41         return $instance;
  42     }
  43
  44 }
  45