[Summary view]

   1  <?php
   2  
   3  /**
   4   * Component of HTMLPurifier_AttrContext that accumulates IDs to prevent dupes
   5   * @note In Slashdot-speak, dupe means duplicate.
   6   * @note The default constructor does not accept $config or $context objects:
   7   *       use must use the static build() factory method to perform initialization.
   8   */
   9  class HTMLPurifier_IDAccumulator
  10  {
  11  
  12      /**
  13       * Lookup table of IDs we've accumulated.
  14       * @public
  15       */
  16      public $ids = array();
  17  
  18      /**
  19       * Builds an IDAccumulator, also initializing the default blacklist
  20       * @param HTMLPurifier_Config $config Instance of HTMLPurifier_Config
  21       * @param HTMLPurifier_Context $context Instance of HTMLPurifier_Context
  22       * @return HTMLPurifier_IDAccumulator Fully initialized HTMLPurifier_IDAccumulator
  23       */
  24      public static function build($config, $context)
  25      {
  26          $id_accumulator = new HTMLPurifier_IDAccumulator();
  27          $id_accumulator->load($config->get('Attr.IDBlacklist'));
  28          return $id_accumulator;
  29      }
  30  
  31      /**
  32       * Add an ID to the lookup table.
  33       * @param string $id ID to be added.
  34       * @return bool status, true if success, false if there's a dupe
  35       */
  36      public function add($id)
  37      {
  38          if (isset($this->ids[$id])) {
  39              return false;
  40          }
  41          return $this->ids[$id] = true;
  42      }
  43  
  44      /**
  45       * Load a list of IDs into the lookup table
  46       * @param $array_of_ids Array of IDs to load
  47       * @note This function doesn't care about duplicates
  48       */
  49      public function load($array_of_ids)
  50      {
  51          foreach ($array_of_ids as $id) {
  52              $this->ids[$id] = true;
  53          }
  54      }
  55  }
  56  
  57  // vim: et sw=4 sts=4