ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: home / lab2454c / healthvalidate.com / vendor / ezyang / htmlpurifier / library / HTMLPurifier

<?php

/**
 * Class that handles operations involving percent-encoding in URIs.
 *
 * @warning
 *      Be careful when reusing instances of PercentEncoder. The object
 *      you use for normalize() SHOULD NOT be used for encode(), or
 *      vice-versa.
 */
class HTMLPurifier_PercentEncoder
{

/**
     * Reserved characters to preserve when using encode().
     * @type array
     */
    protected $preserve = array();

/**
     * String of characters that should be preserved while using encode().
     * @param bool $preserve
     */
    public function __construct($preserve = false)
    {
        // unreserved letters, ought to const-ify
        for ($i = 48; $i <= 57; $i++) { // digits
            $this->preserve[$i] = true;
        }
        for ($i = 65; $i <= 90; $i++) { // upper-case
            $this->preserve[$i] = true;
        }
        for ($i = 97; $i <= 122; $i++) { // lower-case
            $this->preserve[$i] = true;
        }
        $this->preserve[45] = true; // Dash         -
        $this->preserve[46] = true; // Period       .
        $this->preserve[95] = true; // Underscore   _
        $this->preserve[126]= true; // Tilde        ~

// extra letters not to escape
        if ($preserve !== false) {
            for ($i = 0, $c = strlen($preserve); $i < $c; $i++) {
                $this->preserve[ord($preserve[$i])] = true;
            }
        }
    }

/**
     * Our replacement for urlencode, it encodes all non-reserved characters,
     * as well as any extra characters that were instructed to be preserved.
     * @note
     *      Assumes that the string has already been normalized, making any
     *      and all percent escape sequences valid. Percents will not be
     *      re-escaped, regardless of their status in $preserve
     * @param string $string String to be encoded
     * @return string Encoded string.
     */
    public function encode($string)
    {
        $ret = '';
        for ($i = 0, $c = strlen($string); $i < $c; $i++) {
            if ($string[$i] !== '%' && !isset($this->preserve[$int = ord($string[$i])])) {
                $ret .= '%' . sprintf('%02X', $int);
            } else {
                $ret .= $string[$i];
            }
        }
        return $ret;
    }

/**
     * Fix up percent-encoding by decoding unreserved characters and normalizing.
     * @warning This function is affected by $preserve, even though the
     *          usual desired behavior is for this not to preserve those
     *          characters. Be careful when reusing instances of PercentEncoder!
     * @param string $string String to normalize
     * @return string
     */
    public function normalize($string)
    {
        if ($string == '') {
            return '';
        }
        $parts = explode('%', $string);
        $ret = array_shift($parts);
        foreach ($parts as $part) {
            $length = strlen($part);
            if ($length < 2) {
                $ret .= '%25' . $part;
                continue;
            }
            $encoding = substr($part, 0, 2);
            $text     = substr($part, 2);
            if (!ctype_xdigit($encoding)) {
                $ret .= '%25' . $part;
                continue;
            }
            $int = hexdec($encoding);
            if (isset($this->preserve[$int])) {
                $ret .= chr($int) . $text;
                continue;
            }
            $encoding = strtoupper($encoding);
            $ret .= '%' . $encoding . $text;
        }
        return $ret;
    }
}

// vim: et sw=4 sts=4

[+] Injector
[-] CSSDefinition.php [edit]
[+] URIScheme
[-] TagTransform.php [edit]
[+] DefinitionCache
[+] HTMLModule
[-] Filter.php [edit]
[-] Language.php [edit]
[+] VarParser
[-] ChildDef.php [edit]
[-] TokenFactory.php [edit]
[-] Printer.php [edit]
[+] Lexer
[-] Context.php [edit]
[+] ..
[+] URIFilter
[-] Encoder.php [edit]
[+] Strategy
[-] Config.php [edit]
[-] DefinitionCacheFactory.php [edit]
[-] Definition.php [edit]
[-] PropertyList.php [edit]
[-] AttrCollections.php [edit]
[-] EntityLookup.php [edit]
[-] LanguageFactory.php [edit]
[-] UnitConverter.php [edit]
[-] Bootstrap.php [edit]
[+] ChildDef
[-] Node.php [edit]
[-] URIDefinition.php [edit]
[-] Length.php [edit]
[+] AttrDef
[-] ElementDef.php [edit]
[-] Injector.php [edit]
[+] ConfigSchema
[-] EntityParser.php [edit]
[-] Token.php [edit]
[-] StringHash.php [edit]
[-] AttrDef.php [edit]
[+] Filter
[-] IDAccumulator.php [edit]
[-] ErrorStruct.php [edit]
[-] HTMLDefinition.php [edit]
[-] StringHashParser.php [edit]
[-] Queue.php [edit]
[-] ErrorCollector.php [edit]
[-] URIParser.php [edit]
[-] URI.php [edit]
[-] ConfigSchema.php [edit]
[-] ContentSets.php [edit]
[-] Doctype.php [edit]
[-] AttrValidator.php [edit]
[-] URIScheme.php [edit]
[-] PropertyListIterator.php [edit]
[-] HTMLModuleManager.php [edit]
[-] Strategy.php [edit]
[-] DefinitionCache.php [edit]
[-] Generator.php [edit]
[-] PercentEncoder.php [edit]
[+] Printer
[-] AttrTransform.php [edit]
[-] Exception.php [edit]
[-] URIFilter.php [edit]
[-] VarParserException.php [edit]
[-] AttrTypes.php [edit]
[+] Token
[+] TagTransform
[+] Language
[+] EntityLookup
[-] Arborize.php [edit]
[-] Lexer.php [edit]
[-] DoctypeRegistry.php [edit]
[+] AttrTransform
[+] Node
[-] URISchemeRegistry.php [edit]
[-] VarParser.php [edit]
[-] HTMLModule.php [edit]
[-] Zipper.php [edit]