mirror of
https://github.com/ezyang/htmlpurifier.git
synced 2024-12-23 17:01:51 +00:00
bf6de96bd0
- Update comments git-svn-id: http://htmlpurifier.org/svnroot/htmlpurifier/trunk@1549 48356398-32a2-884e-a903-53898d9a118a
90 lines
2.7 KiB
PHP
90 lines
2.7 KiB
PHP
<?php
|
|
|
|
/**
|
|
* Validates a URI as defined by RFC 3986.
|
|
* @note Scheme-specific mechanics deferred to HTMLPurifier_URIScheme
|
|
*/
|
|
class HTMLPurifier_AttrDef_URI extends HTMLPurifier_AttrDef
|
|
{
|
|
|
|
protected $parser, $percentEncoder;
|
|
protected $embedsResource;
|
|
|
|
/**
|
|
* @param $embeds_resource_resource Does the URI here result in an extra HTTP request?
|
|
*/
|
|
public function __construct($embeds_resource = false) {
|
|
$this->parser = new HTMLPurifier_URIParser();
|
|
$this->percentEncoder = new HTMLPurifier_PercentEncoder();
|
|
$this->embedsResource = (bool) $embeds_resource;
|
|
}
|
|
|
|
public function validate($uri, $config, $context) {
|
|
|
|
if ($config->get('URI', 'Disable')) return false;
|
|
|
|
// initial operations
|
|
$uri = $this->parseCDATA($uri);
|
|
$uri = $this->percentEncoder->normalize($uri);
|
|
|
|
// parse the URI
|
|
$uri = $this->parser->parse($uri);
|
|
if ($uri === false) return false;
|
|
|
|
// add embedded flag to context for validators
|
|
$context->register('EmbeddedURI', $this->embedsResource);
|
|
|
|
$ok = false;
|
|
do {
|
|
|
|
// generic validation
|
|
$result = $uri->validate($config, $context);
|
|
if (!$result) break;
|
|
|
|
// chained filtering
|
|
$uri_def =& $config->getDefinition('URI');
|
|
$result = $uri_def->filter($uri, $config, $context);
|
|
if (!$result) break;
|
|
|
|
// scheme-specific validation
|
|
$scheme_obj = $uri->getSchemeObj($config, $context);
|
|
if (!$scheme_obj) break;
|
|
if ($this->embedsResource && !$scheme_obj->browsable) break;
|
|
$result = $scheme_obj->validate($uri, $config, $context);
|
|
if (!$result) break;
|
|
|
|
// survived gauntlet
|
|
$ok = true;
|
|
|
|
} while (false);
|
|
|
|
$context->destroy('EmbeddedURI');
|
|
if (!$ok) return false;
|
|
|
|
// munge scheme off if necessary (this must be last)
|
|
if (!is_null($uri->scheme) && is_null($uri->host)) {
|
|
if ($uri_def->defaultScheme == $uri->scheme) {
|
|
$uri->scheme = null;
|
|
}
|
|
}
|
|
|
|
// back to string
|
|
$result = $uri->toString();
|
|
|
|
// munge entire URI if necessary
|
|
if (
|
|
!is_null($uri->host) && // indicator for authority
|
|
!empty($scheme_obj->browsable) &&
|
|
!is_null($munge = $config->get('URI', 'Munge'))
|
|
) {
|
|
$result = str_replace('%s', rawurlencode($result), $munge);
|
|
}
|
|
|
|
return $result;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|