XOOPS 2.5.6  Final
 All Classes Namespaces Files Functions Variables Pages
HTMLPurifier Class Reference

Public Member Functions

 __construct ($config=null)
 
 addFilter ($filter)
 
 purify ($html, $config=null)
 
 purifyArray ($array_of_html, $config=null)
 

Static Public Member Functions

static getInstance ($prototype=null)
 
static instance ($prototype=null)
 

Public Attributes

 $config
 
 $context
 
 $generator
 
 $version = '4.4.0'
 
const VERSION = '4.4.0'
 

Protected Attributes

 $strategy
 

Private Attributes

 $filters = array()
 

Static Private Attributes

static $instance
 

Detailed Description

Facade that coordinates HTML Purifier's subsystems in order to purify HTML.

Note
There are several points in which configuration can be specified for HTML Purifier. The precedence of these (from lowest to highest) is as follows:
  1. Instance: new HTMLPurifier($config)
  2. Invocation: purify($html, $config) These configurations are entirely independent of each other and are not merged (this behavior may change in the future).
Todo:
We need an easier way to inject strategies using the configuration object.

Definition at line 54 of file HTMLPurifier.php.

Constructor & Destructor Documentation

HTMLPurifier::__construct (   $config = null)

Initializes the purifier.

Parameters
$configOptional HTMLPurifier_Config object for all instances of the purifier, if omitted, a default configuration is supplied (which can be overridden on a per-use basis). The parameter can also be any type that HTMLPurifier_Config::create() supports.

Definition at line 88 of file HTMLPurifier.php.

References $config, and HTMLPurifier_Config\create().

Here is the call graph for this function:

Member Function Documentation

HTMLPurifier::addFilter (   $filter)

Adds a filter to process the output. First come first serve

Parameters
$filterHTMLPurifier_Filter object

Definition at line 100 of file HTMLPurifier.php.

References $filter.

static HTMLPurifier::getInstance (   $prototype = null)
static
Note
Backwards compatibility, see instance()

Definition at line 231 of file HTMLPurifier.php.

References instance().

Referenced by HTMLPurifier_ConfigSchema_Builder_Xml\writeHTMLDiv().

Here is the call graph for this function:

Here is the caller graph for this function:

static HTMLPurifier::instance (   $prototype = null)
static

Singleton for enforcing just one HTML Purifier in your system

Parameters
$prototypeOptional prototype HTMLPurifier instance to overload singleton with, or HTMLPurifier_Config instance to configure the generated version with.

Definition at line 215 of file HTMLPurifier.php.

References HTMLPurifier().

Referenced by getInstance().

Here is the call graph for this function:

Here is the caller graph for this function:

HTMLPurifier::purify (   $html,
  $config = null 
)

Filters an HTML snippet/document to be XSS-free and standards-compliant.

Parameters
$htmlString of HTML to purify
$configHTMLPurifier_Config object for this operation, if omitted, defaults to the config object specified during this object's construction. The parameter can also be any type that HTMLPurifier_Config::create() supports.
Returns
Purified HTML

Definition at line 115 of file HTMLPurifier.php.

References $config, $context, $filter, $filters, $html, $i, $language, HTMLPurifier_IDAccumulator\build(), HTMLPurifier_Encoder\convertFromUTF8(), HTMLPurifier_Encoder\convertToUTF8(), HTMLPurifier_Lexer\create(), HTMLPurifier_Config\create(), and HTMLPurifier_LanguageFactory\instance().

Referenced by purifyArray().

Here is the call graph for this function:

Here is the caller graph for this function:

HTMLPurifier::purifyArray (   $array_of_html,
  $config = null 
)

Filters an array of HTML snippets

Parameters
$configOptional HTMLPurifier_Config object for this operation. See HTMLPurifier::purify() for more details.
Returns
Array of purified HTML

Definition at line 199 of file HTMLPurifier.php.

References $config, $context, $html, and purify().

Here is the call graph for this function:

Member Data Documentation

HTMLPurifier::$config

Global configuration object

Definition at line 64 of file HTMLPurifier.php.

Referenced by __construct(), purify(), and purifyArray().

HTMLPurifier::$context

Resultant HTMLPurifier_Context of last run purification. Is an array of contexts if the last called method was purifyArray().

Definition at line 78 of file HTMLPurifier.php.

Referenced by purify(), and purifyArray().

HTMLPurifier::$filters = array()
private

Array of extra HTMLPurifier_Filter objects to run on HTML, for backwards compatibility

Definition at line 67 of file HTMLPurifier.php.

Referenced by purify().

HTMLPurifier::$generator

Definition at line 72 of file HTMLPurifier.php.

HTMLPurifier::$instance
staticprivate

Single instance of HTML Purifier

Definition at line 70 of file HTMLPurifier.php.

HTMLPurifier::$strategy
protected

Definition at line 72 of file HTMLPurifier.php.

HTMLPurifier::$version = '4.4.0'

Version of HTML Purifier

Definition at line 58 of file HTMLPurifier.php.

const HTMLPurifier::VERSION = '4.4.0'

Constant with version of HTML Purifier

Definition at line 61 of file HTMLPurifier.php.


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