File indexing completed on 2024-12-22 05:36:21

 <?php
 
 /**
  * Represents a language and defines localizable string formatting and
  * other functions, as well as the localized messages for HTML Purifier.
  */
 class HTMLPurifier_Language
 {
 
     /**
      * ISO 639 language code of language. Prefers shortest possible version.
      * @type string
      */
     public $code = 'en';
 
     /**
      * Fallback language code.
      * @type bool|string
      */
     public $fallback = false;
 
     /**
      * Array of localizable messages.
      * @type array
      */
     public $messages = array();
 
     /**
      * Array of localizable error codes.
      * @type array
      */
     public $errorNames = array();
 
     /**
      * True if no message file was found for this language, so English
      * is being used instead. Check this if you'd like to notify the
      * user that they've used a non-supported language.
      * @type bool
      */
     public $error = false;
 
     /**
      * Has the language object been loaded yet?
      * @type bool
      * @todo Make it private, fix usage in HTMLPurifier_LanguageTest
      */
     public $_loaded = false;
 
     /**
      * @type HTMLPurifier_Config
      */
     protected $config;
 
     /**
      * @type HTMLPurifier_Context
      */
     protected $context;
 
     /**
      * @param HTMLPurifier_Config $config
      * @param HTMLPurifier_Context $context
      */
     public function __construct($config, $context)
     {
         $this->config  = $config;
         $this->context = $context;
     }
 
     /**
      * Loads language object with necessary info from factory cache
      * @note This is a lazy loader
      */
     public function load()
     {
         if ($this->_loaded) {
             return;
         }
         $factory = HTMLPurifier_LanguageFactory::instance();
         $factory->loadLanguage($this->code);
         foreach ($factory->keys as $key) {
             $this->$key = $factory->cache[$this->code][$key];
         }
         $this->_loaded = true;
     }
 
     /**
      * Retrieves a localised message.
      * @param string $key string identifier of message
      * @return string localised message
      */
     public function getMessage($key)
     {
         if (!$this->_loaded) {
             $this->load();
         }
         if (!isset($this->messages[$key])) {
             return "[$key]";
         }
         return $this->messages[$key];
     }
 
     /**
      * Retrieves a localised error name.
      * @param int $int error number, corresponding to PHP's error reporting
      * @return string localised message
      */
     public function getErrorName($int)
     {
         if (!$this->_loaded) {
             $this->load();
         }
         if (!isset($this->errorNames[$int])) {
             return "[Error: $int]";
         }
         return $this->errorNames[$int];
     }
 
     /**
      * Converts an array list into a string readable representation
      * @param array $array
      * @return string
      */
     public function listify($array)
     {
         $sep      = $this->getMessage('Item separator');
         $sep_last = $this->getMessage('Item separator last');
         $ret = '';
         for ($i = 0, $c = count($array); $i < $c; $i++) {
             if ($i == 0) {
             } elseif ($i + 1 < $c) {
                 $ret .= $sep;
             } else {
                 $ret .= $sep_last;
             }
             $ret .= $array[$i];
         }
         return $ret;
     }
 
     /**
      * Formats a localised message with passed parameters
      * @param string $key string identifier of message
      * @param array $args Parameters to substitute in
      * @return string localised message
      * @todo Implement conditionals? Right now, some messages make
      *     reference to line numbers, but those aren't always available
      */
     public function formatMessage($key, $args = array())
     {
         if (!$this->_loaded) {
             $this->load();
         }
         if (!isset($this->messages[$key])) {
             return "[$key]";
         }
         $raw = $this->messages[$key];
         $subst = array();
         $generator = false;
         foreach ($args as $i => $value) {
             if (is_object($value)) {
                 if ($value instanceof HTMLPurifier_Token) {
                     // factor this out some time
                     if (!$generator) {
                         $generator = $this->context->get('Generator');
                     }
                     if (isset($value->name)) {
                         $subst['$'.$i.'.Name'] = $value->name;
                     }
                     if (isset($value->data)) {
                         $subst['$'.$i.'.Data'] = $value->data;
                     }
                     $subst['$'.$i.'.Compact'] =
                     $subst['$'.$i.'.Serialized'] = $generator->generateFromToken($value);
                     // a more complex algorithm for compact representation
                     // could be introduced for all types of tokens. This
                     // may need to be factored out into a dedicated class
                     if (!empty($value->attr)) {
                         $stripped_token = clone $value;
                         $stripped_token->attr = array();
                         $subst['$'.$i.'.Compact'] = $generator->generateFromToken($stripped_token);
                     }
                     $subst['$'.$i.'.Line'] = $value->line ? $value->line : 'unknown';
                 }
                 continue;
             } elseif (is_array($value)) {
                 $keys = array_keys($value);
                 if (array_keys($keys) === $keys) {
                     // list
                     $subst['$'.$i] = $this->listify($value);
                 } else {
                     // associative array
                     // no $i implementation yet, sorry
                     $subst['$'.$i.'.Keys'] = $this->listify($keys);
                     $subst['$'.$i.'.Values'] = $this->listify(array_values($value));
                 }
                 continue;
             }
             $subst['$' . $i] = $value;
         }
         return strtr($raw, $subst);
     }
 }
 
 // vim: et sw=4 sts=4