HTMLPurifier_URIParser Class Reference

Parses a URI into the components and fragment identifier as specified by RFC 3986. More...

Collaboration diagram for HTMLPurifier_URIParser:

Public Member Functions
	__construct ()
	parse ($uri)
	Parses a URI.

Protected Attributes
	$percentEncoder
	Instance of HTMLPurifier_PercentEncoder to do normalization with.

Detailed Description

Parses a URI into the components and fragment identifier as specified by RFC 3986.

Definition at line 7 of file URIParser.php.

Constructor & Destructor Documentation

HTMLPurifier_URIParser::__construct

(

)

Definition at line 15 of file URIParser.php.

    {
        $this->percentEncoder = new HTMLPurifier_PercentEncoder();
    }

Member Function Documentation

HTMLPurifier_URIParser::parse

(

$uri

)

Parses a URI.

Parameters

$uri	string URI to parse

Returns

HTMLPurifier_URI representation of URI. This representation has not been validated yet and may not conform to RFC.

Definition at line 26 of file URIParser.php.

References $path, $query, and $result.

    {
        $uri = $this->percentEncoder->normalize($uri);

        // Regexp is as per Appendix B.
        // Note that ["<>] are an addition to the RFC's recommended
        // characters, because they represent external delimeters.
        $r_URI = '!'.
            '(([a-zA-Z0-9\.\+\-]+):)?'. // 2. Scheme
            '(//([^/?#"<>]*))?'. // 4. Authority
            '([^?#"<>]*)'.       // 5. Path
            '(\?([^#"<>]*))?'.   // 7. Query
            '(#([^"<>]*))?'.     // 8. Fragment
            '!';

        $matches = array();
        $result = preg_match($r_URI, $uri, $matches);

        if (!$result) return false; // *really* invalid URI

        // seperate out parts
        $scheme     = !empty($matches[1]) ? $matches[2] : null;
        $authority  = !empty($matches[3]) ? $matches[4] : null;
        $path       = $matches[5]; // always present, can be empty
        $query      = !empty($matches[6]) ? $matches[7] : null;
        $fragment   = !empty($matches[8]) ? $matches[9] : null;

        // further parse authority
        if ($authority !== null) {
            $r_authority = "/^((.+?)@)?(\[[^\]]+\]|[^:]*)(:(\d*))?/";
            $matches = array();
            preg_match($r_authority, $authority, $matches);
            $userinfo   = !empty($matches[1]) ? $matches[2] : null;
            $host       = !empty($matches[3]) ? $matches[3] : '';
            $port       = !empty($matches[4]) ? (int) $matches[5] : null;
        } else {
            $port = $host = $userinfo = null;
        }

        return new HTMLPurifier_URI(
            $scheme, $userinfo, $host, $port, $path, $query, $fragment);
    }

Field Documentation

HTMLPurifier_URIParser::$percentEncoder

protected

Instance of HTMLPurifier_PercentEncoder to do normalization with.

Definition at line 13 of file URIParser.php.

---

The documentation for this class was generated from the following file:

• Services/Html/HtmlPurifier/library/HTMLPurifier/URIParser.php