remove autoload section in composer.json

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

<?php\r
\r
/**\r
 * Validator for the components of a URI for a specific scheme\r
 */\r
abstract class HTMLPurifier_URIScheme\r
{\r
\r
    /**\r
     * Scheme's default port (integer). If an explicit port number is\r
     * specified that coincides with the default port, it will be\r
     * elided.\r
     * @type int\r
     */\r
    public $default_port = null;\r
\r
    /**\r
     * Whether or not URIs of this scheme are locatable by a browser\r
     * http and ftp are accessible, while mailto and news are not.\r
     * @type bool\r
     */\r
    public $browsable = false;\r
\r
    /**\r
     * Whether or not data transmitted over this scheme is encrypted.\r
     * https is secure, http is not.\r
     * @type bool\r
     */\r
    public $secure = false;\r
\r
    /**\r
     * Whether or not the URI always uses <hier_part>, resolves edge cases\r
     * with making relative URIs absolute\r
     * @type bool\r
     */\r
    public $hierarchical = false;\r
\r
    /**\r
     * Whether or not the URI may omit a hostname when the scheme is\r
     * explicitly specified, ala file:///path/to/file. As of writing,\r
     * 'file' is the only scheme that browsers support his properly.\r
     * @type bool\r
     */\r
    public $may_omit_host = false;\r
\r
    /**\r
     * Validates the components of a URI for a specific scheme.\r
     * @param HTMLPurifier_URI $uri Reference to a HTMLPurifier_URI object\r
     * @param HTMLPurifier_Config $config\r
     * @param HTMLPurifier_Context $context\r
     * @return bool success or failure\r
     */\r
    abstract public function doValidate(&$uri, $config, $context);\r
\r
    /**\r
     * Public interface for validating components of a URI.  Performs a\r
     * bunch of default actions. Don't overload this method.\r
     * @param HTMLPurifier_URI $uri Reference to a HTMLPurifier_URI object\r
     * @param HTMLPurifier_Config $config\r
     * @param HTMLPurifier_Context $context\r
     * @return bool success or failure\r
     */\r
    public function validate(&$uri, $config, $context)\r
    {\r
        if ($this->default_port == $uri->port) {\r
            $uri->port = null;\r
        }\r
        // kludge: browsers do funny things when the scheme but not the\r
        // authority is set\r
        if (!$this->may_omit_host &&\r
            // if the scheme is present, a missing host is always in error\r
            (!is_null($uri->scheme) && ($uri->host === '' || is_null($uri->host))) ||\r
            // if the scheme is not present, a *blank* host is in error,\r
            // since this translates into '///path' which most browsers\r
            // interpret as being 'http://path'.\r
            (is_null($uri->scheme) && $uri->host === '')\r
        ) {\r
            do {\r
                if (is_null($uri->scheme)) {\r
                    if (substr($uri->path, 0, 2) != '//') {\r
                        $uri->host = null;\r
                        break;\r
                    }\r
                    // URI is '////path', so we cannot nullify the\r
                    // host to preserve semantics.  Try expanding the\r
                    // hostname instead (fall through)\r
                }\r
                // first see if we can manually insert a hostname\r
                $host = $config->get('URI.Host');\r
                if (!is_null($host)) {\r
                    $uri->host = $host;\r
                } else {\r
                    // we can't do anything sensible, reject the URL.\r
                    return false;\r
                }\r
            } while (false);\r
        }\r
        return $this->doValidate($uri, $config, $context);\r
    }\r
}\r
\r
// vim: et sw=4 sts=4\r