\HTMLPurifier_URIFilter

Chainable filters for custom URI processing.

These filters can perform custom actions on a URI filter object, including transformation or blacklisting. A filter named Foo must have a corresponding configuration directive %URI.Foo, unless always_load is specified to be true.

The following contexts may be available while URIFilters are being processed:

 - EmbeddedURI: true if URI is an embedded resource that will
   be loaded automatically on page load
 - CurrentToken: a reference to the token that is currently
   being processed
 - CurrentAttr: the name of the attribute that is currently being
   processed
 - CurrentCSSProperty: the name of the CSS property that is
   currently being processed (if applicable)

Summary

Methods
Properties
Constants
prepare()
filter()
$name
$post
$always_load
No constants found
No protected methods found
No protected properties found
N/A
No private methods found
No private properties found
N/A

Properties

$name

$name

Unique identifier of filter.

$post

$post

True if this filter should be run after scheme validation.

$always_load

$always_load

True if this filter should always be loaded.

This permits a filter to be named Foo without the corresponding %URI.Foo directive existing.

Methods

prepare()

prepare(\HTMLPurifier_Config  $config) : bool

Performs initialization for the filter. If the filter returns false, this means that it shouldn't be considered active.

Parameters

\HTMLPurifier_Config $config

Returns

bool —

filter()

filter(\HTMLPurifier_URI  $uri, \HTMLPurifier_Config  $config, \HTMLPurifier_Context  $context) : bool

Filter a URI object

Parameters

\HTMLPurifier_URI $uri

Reference to URI object variable

\HTMLPurifier_Config $config
\HTMLPurifier_Context $context

Returns

bool —

Whether or not to continue processing: false indicates URL is no good, true indicates continue processing. Note that all changes are committed directly on the URI object