remove autoload section in composer.json

[github/wallabag/wallabag.git] / inc / 3rdparty / htmlpurifier / HTMLPurifier / LanguageFactory.php

<?php\r
\r
/**\r
 * Class responsible for generating HTMLPurifier_Language objects, managing\r
 * caching and fallbacks.\r
 * @note Thanks to MediaWiki for the general logic, although this version\r
 *       has been entirely rewritten\r
 * @todo Serialized cache for languages\r
 */\r
class HTMLPurifier_LanguageFactory\r
{\r
\r
    /**\r
     * Cache of language code information used to load HTMLPurifier_Language objects.\r
     * Structure is: $factory->cache[$language_code][$key] = $value\r
     * @type array\r
     */\r
    public $cache;\r
\r
    /**\r
     * Valid keys in the HTMLPurifier_Language object. Designates which\r
     * variables to slurp out of a message file.\r
     * @type array\r
     */\r
    public $keys = array('fallback', 'messages', 'errorNames');\r
\r
    /**\r
     * Instance to validate language codes.\r
     * @type HTMLPurifier_AttrDef_Lang\r
     *\r
     */\r
    protected $validator;\r
\r
    /**\r
     * Cached copy of dirname(__FILE__), directory of current file without\r
     * trailing slash.\r
     * @type string\r
     */\r
    protected $dir;\r
\r
    /**\r
     * Keys whose contents are a hash map and can be merged.\r
     * @type array\r
     */\r
    protected $mergeable_keys_map = array('messages' => true, 'errorNames' => true);\r
\r
    /**\r
     * Keys whose contents are a list and can be merged.\r
     * @value array lookup\r
     */\r
    protected $mergeable_keys_list = array();\r
\r
    /**\r
     * Retrieve sole instance of the factory.\r
     * @param HTMLPurifier_LanguageFactory $prototype Optional prototype to overload sole instance with,\r
     *                   or bool true to reset to default factory.\r
     * @return HTMLPurifier_LanguageFactory\r
     */\r
    public static function instance($prototype = null)\r
    {\r
        static $instance = null;\r
        if ($prototype !== null) {\r
            $instance = $prototype;\r
        } elseif ($instance === null || $prototype == true) {\r
            $instance = new HTMLPurifier_LanguageFactory();\r
            $instance->setup();\r
        }\r
        return $instance;\r
    }\r
\r
    /**\r
     * Sets up the singleton, much like a constructor\r
     * @note Prevents people from getting this outside of the singleton\r
     */\r
    public function setup()\r
    {\r
        $this->validator = new HTMLPurifier_AttrDef_Lang();\r
        $this->dir = HTMLPURIFIER_PREFIX . '/HTMLPurifier';\r
    }\r
\r
    /**\r
     * Creates a language object, handles class fallbacks\r
     * @param HTMLPurifier_Config $config\r
     * @param HTMLPurifier_Context $context\r
     * @param bool|string $code Code to override configuration with. Private parameter.\r
     * @return HTMLPurifier_Language\r
     */\r
    public function create($config, $context, $code = false)\r
    {\r
        // validate language code\r
        if ($code === false) {\r
            $code = $this->validator->validate(\r
                $config->get('Core.Language'),\r
                $config,\r
                $context\r
            );\r
        } else {\r
            $code = $this->validator->validate($code, $config, $context);\r
        }\r
        if ($code === false) {\r
            $code = 'en'; // malformed code becomes English\r
        }\r
\r
        $pcode = str_replace('-', '_', $code); // make valid PHP classname\r
        static $depth = 0; // recursion protection\r
\r
        if ($code == 'en') {\r
            $lang = new HTMLPurifier_Language($config, $context);\r
        } else {\r
            $class = 'HTMLPurifier_Language_' . $pcode;\r
            $file  = $this->dir . '/Language/classes/' . $code . '.php';\r
            if (file_exists($file) || class_exists($class, false)) {\r
                $lang = new $class($config, $context);\r
            } else {\r
                // Go fallback\r
                $raw_fallback = $this->getFallbackFor($code);\r
                $fallback = $raw_fallback ? $raw_fallback : 'en';\r
                $depth++;\r
                $lang = $this->create($config, $context, $fallback);\r
                if (!$raw_fallback) {\r
                    $lang->error = true;\r
                }\r
                $depth--;\r
            }\r
        }\r
        $lang->code = $code;\r
        return $lang;\r
    }\r
\r
    /**\r
     * Returns the fallback language for language\r
     * @note Loads the original language into cache\r
     * @param string $code language code\r
     * @return string|bool\r
     */\r
    public function getFallbackFor($code)\r
    {\r
        $this->loadLanguage($code);\r
        return $this->cache[$code]['fallback'];\r
    }\r
\r
    /**\r
     * Loads language into the cache, handles message file and fallbacks\r
     * @param string $code language code\r
     */\r
    public function loadLanguage($code)\r
    {\r
        static $languages_seen = array(); // recursion guard\r
\r
        // abort if we've already loaded it\r
        if (isset($this->cache[$code])) {\r
            return;\r
        }\r
\r
        // generate filename\r
        $filename = $this->dir . '/Language/messages/' . $code . '.php';\r
\r
        // default fallback : may be overwritten by the ensuing include\r
        $fallback = ($code != 'en') ? 'en' : false;\r
\r
        // load primary localisation\r
        if (!file_exists($filename)) {\r
            // skip the include: will rely solely on fallback\r
            $filename = $this->dir . '/Language/messages/en.php';\r
            $cache = array();\r
        } else {\r
            include $filename;\r
            $cache = compact($this->keys);\r
        }\r
\r
        // load fallback localisation\r
        if (!empty($fallback)) {\r
\r
            // infinite recursion guard\r
            if (isset($languages_seen[$code])) {\r
                trigger_error(\r
                    'Circular fallback reference in language ' .\r
                    $code,\r
                    E_USER_ERROR\r
                );\r
                $fallback = 'en';\r
            }\r
            $language_seen[$code] = true;\r
\r
            // load the fallback recursively\r
            $this->loadLanguage($fallback);\r
            $fallback_cache = $this->cache[$fallback];\r
\r
            // merge fallback with current language\r
            foreach ($this->keys as $key) {\r
                if (isset($cache[$key]) && isset($fallback_cache[$key])) {\r
                    if (isset($this->mergeable_keys_map[$key])) {\r
                        $cache[$key] = $cache[$key] + $fallback_cache[$key];\r
                    } elseif (isset($this->mergeable_keys_list[$key])) {\r
                        $cache[$key] = array_merge($fallback_cache[$key], $cache[$key]);\r
                    }\r
                } else {\r
                    $cache[$key] = $fallback_cache[$key];\r
                }\r
            }\r
        }\r
\r
        // save to cache for later retrieval\r
        $this->cache[$code] = $cache;\r
        return;\r
    }\r
}\r
\r
// vim: et sw=4 sts=4\r