|
ILIAS
Release_4_0_x_branch Revision 61816
|
Configuration object that triggers customizable behavior. More...
Collaboration diagram for HTMLPurifier_Config:Public Member Functions | |
| __construct ($definition, $parent=null) | |
| get ($key, $a=null) | |
| Retreives a value from the configuration. | |
| getBatch ($namespace) | |
| Retreives an array of directives to values from a given namespace. | |
| getBatchSerial ($namespace) | |
| Returns a md5 signature of a segment of the configuration object that uniquely identifies that particular configuration. | |
| getSerial () | |
| Returns a md5 signature for the entire configuration object that uniquely identifies that particular configuration. | |
| getAll () | |
| Retrieves all directives, organized by namespace. | |
| set ($key, $value, $a=null) | |
| Sets a value to configuration. | |
| getHTMLDefinition ($raw=false) | |
| Retrieves object reference to the HTML definition. | |
| getCSSDefinition ($raw=false) | |
| Retrieves object reference to the CSS definition. | |
| getDefinition ($type, $raw=false) | |
| Retrieves a definition. | |
| loadArray ($config_array) | |
| Loads configuration values from an array with the following structure: Namespace.Directive => Value. | |
| mergeArrayFromForm ($array, $index=false, $allowed=true, $mq_fix=true) | |
| Merges in configuration values from $_GET/$_POST to object. | |
| loadIni ($filename) | |
| Loads configuration values from an ini file. | |
| isFinalized ($error=false) | |
| Checks whether or not the configuration object is finalized. | |
| autoFinalize () | |
| Finalizes configuration only if auto finalize is on and not already finalized. | |
| finalize () | |
| Finalizes a configuration object, prohibiting further change. | |
| serialize () | |
| Returns a serialized form of the configuration object that can be reconstituted. | |
Static Public Member Functions | |
| static | create ($config, $schema=null) |
| Convenience constructor that creates a config object based on a mixed var. | |
| static | inherit (HTMLPurifier_Config $config) |
| Creates a new config object that inherits from a previous one. | |
| static | createDefault () |
| Convenience constructor that creates a default configuration object. | |
| static | getAllowedDirectivesForForm ($allowed, $schema=null) |
| Returns a list of array(namespace, directive) for all directives that are allowed in a web-form context as per an allowed namespaces/directives list. | |
| static | loadArrayFromForm ($array, $index=false, $allowed=true, $mq_fix=true, $schema=null) |
| Loads configuration values from $_GET/$_POST that were posted via ConfigForm. | |
| static | prepareArrayFromForm ($array, $index=false, $allowed=true, $mq_fix=true, $schema=null) |
| Prepares an array from a form into something usable for the more strict parts of HTMLPurifier_Config. | |
Data Fields | |
| $version = '4.0.0' | |
| HTML Purifier's version. | |
| $autoFinalize = true | |
| Bool indicator whether or not to automatically finalize the object if a read operation is done. | |
| $def | |
| Reference HTMLPurifier_ConfigSchema for value checking. | |
| $chatty = true | |
| Set to false if you do not want line and file numbers in errors (useful when unit testing) | |
Protected Member Functions | |
| triggerError ($msg, $no) | |
| Produces a nicely formatted error message by supplying the stack frame information from two levels up and OUTSIDE of HTMLPurifier_Config. | |
Protected Attributes | |
| $serials = array() | |
| Namespace indexed array of serials for specific namespaces (see getSerial() for more info). | |
| $serial | |
| Serial for entire configuration object. | |
| $parser | |
| Parser for variables. | |
| $definitions | |
| Indexed array of definitions. | |
| $finalized = false | |
| Bool indicator whether or not config is finalized. | |
| $plist | |
| Property list containing configuration directives. | |
Private Member Functions | |
| _listify ($lookup) | |
| Convenience function for error reporting. | |
Private Attributes | |
| $aliasMode | |
| Whether or not a set is taking place due to an alias lookup. | |
| $lock | |
| Current lock; only gets to this namespace are allowed. | |
Configuration object that triggers customizable behavior.
Definition at line 17 of file Config.php.
| HTMLPurifier_Config::__construct | ( | $definition, | |
$parent = null |
|||
| ) |
| $definition | HTMLPurifier_ConfigSchema that defines what directives are allowed. |
Definition at line 92 of file Config.php.
|
private |
| HTMLPurifier_Config::autoFinalize | ( | ) |
Finalizes configuration only if auto finalize is on and not already finalized.
Definition at line 534 of file Config.php.
References finalize().
Referenced by get(), getAll(), getBatch(), and getDefinition().
Here is the call graph for this function:
Here is the caller graph for this function:
|
static |
Convenience constructor that creates a config object based on a mixed var.
| mixed | $config | Variable that defines the state of the config object. Can be: a HTMLPurifier_Config() object, an array of directives based on loadArray(), or a string filename of an ini file. |
| HTMLPurifier_ConfigSchema | Schema object |
Definition at line 108 of file Config.php.
References $config, $ret, createDefault(), and elseif().
Referenced by HTMLPurifier\__construct(), loadArrayFromForm(), and HTMLPurifier\purify().
Here is the call graph for this function:
Here is the caller graph for this function:
|
static |
Convenience constructor that creates a default configuration object.
Definition at line 137 of file Config.php.
References $config, and HTMLPurifier_ConfigSchema\instance().
Referenced by create(), ilHtmlForumPostPurifier\getPurifierConfigInstance(), HTMLPurifier_URISchemeRegistry\getScheme(), and kses().
Here is the call graph for this function:
Here is the caller graph for this function:| HTMLPurifier_Config::finalize | ( | ) |
Finalizes a configuration object, prohibiting further change.
Definition at line 545 of file Config.php.
Referenced by autoFinalize().
Here is the caller graph for this function:| HTMLPurifier_Config::get | ( | $key, | |
$a = null |
|||
| ) |
Retreives a value from the configuration.
| $key | String key |
Definition at line 147 of file Config.php.
References $d, $key, autoFinalize(), and triggerError().
Here is the call graph for this function:| HTMLPurifier_Config::getAll | ( | ) |
Retrieves all directives, organized by namespace.
Definition at line 221 of file Config.php.
References $key, $name, $ret, and autoFinalize().
Referenced by getBatch(), and getSerial().
Here is the call graph for this function:
Here is the caller graph for this function:
|
static |
Returns a list of array(namespace, directive) for all directives that are allowed in a web-form context as per an allowed namespaces/directives list.
| $allowed | List of allowed namespaces/directives |
Definition at line 424 of file Config.php.
References $def, $key, $ret, and HTMLPurifier_ConfigSchema\instance().
Referenced by prepareArrayFromForm(), and HTMLPurifier_Printer_ConfigForm\render().
Here is the call graph for this function:
Here is the caller graph for this function:| HTMLPurifier_Config::getBatch | ( | $namespace | ) |
Retreives an array of directives to values from a given namespace.
| $namespace | String namespace |
Definition at line 179 of file Config.php.
References $namespace, autoFinalize(), getAll(), and triggerError().
Referenced by getBatchSerial().
Here is the call graph for this function:
Here is the caller graph for this function:| HTMLPurifier_Config::getBatchSerial | ( | $namespace | ) |
Returns a md5 signature of a segment of the configuration object that uniquely identifies that particular configuration.
| $namespace | Namespace to get serial for |
Definition at line 197 of file Config.php.
References $namespace, getBatch(), and serialize().
Here is the call graph for this function:| HTMLPurifier_Config::getCSSDefinition | ( | $raw = false | ) |
Retrieves object reference to the CSS definition.
| $raw | Return a copy that has not been setup yet. Must be called before it's been setup, otherwise won't work. |
Definition at line 331 of file Config.php.
References getDefinition().
Here is the call graph for this function:| HTMLPurifier_Config::getDefinition | ( | $type, | |
$raw = false |
|||
| ) |
Retrieves a definition.
| $type | Type of definition: HTML, CSS, etc |
| $raw | Whether or not definition should be returned raw |
Definition at line 340 of file Config.php.
References $cache, $lock, $type, autoFinalize(), elseif(), and HTMLPurifier_DefinitionCacheFactory\instance().
Referenced by getCSSDefinition(), getHTMLDefinition(), and serialize().
Here is the call graph for this function:
Here is the caller graph for this function:| HTMLPurifier_Config::getHTMLDefinition | ( | $raw = false | ) |
Retrieves object reference to the HTML definition.
| $raw | Return a copy that has not been setup yet. Must be called before it's been setup, otherwise won't work. |
Definition at line 322 of file Config.php.
References getDefinition().
Here is the call graph for this function:| HTMLPurifier_Config::getSerial | ( | ) |
Returns a md5 signature for the entire configuration object that uniquely identifies that particular configuration.
Definition at line 210 of file Config.php.
References $serial, getAll(), and serialize().
Here is the call graph for this function:
|
static |
Creates a new config object that inherits from a previous one.
| HTMLPurifier_Config | $config | Configuration object to inherit from. |
Definition at line 129 of file Config.php.
| HTMLPurifier_Config::isFinalized | ( | $error = false | ) |
Checks whether or not the configuration object is finalized.
| $error | String error message, or false for no error |
Definition at line 523 of file Config.php.
References $error, $finalized, and triggerError().
Referenced by loadArray(), loadIni(), and set().
Here is the call graph for this function:
Here is the caller graph for this function:| HTMLPurifier_Config::loadArray | ( | $config_array | ) |
Loads configuration values from an array with the following structure: Namespace.Directive => Value.
| $config_array | Configuration associative array |
Definition at line 402 of file Config.php.
References $key, $namespace, and isFinalized().
Referenced by loadIni(), and mergeArrayFromForm().
Here is the call graph for this function:
Here is the caller graph for this function:
|
static |
Loads configuration values from $_GET/$_POST that were posted via ConfigForm.
| $array | $_GET or $_POST array to import |
| $index | Index/name that the config variables are in |
| $allowed | List of allowed namespaces/directives |
| $mq_fix | Boolean whether or not to enable magic quotes fix |
| $schema | Instance of HTMLPurifier_ConfigSchema to use, if not global copy |
Definition at line 470 of file Config.php.
References $config, $ret, create(), and prepareArrayFromForm().
Here is the call graph for this function:| HTMLPurifier_Config::loadIni | ( | $filename | ) |
Loads configuration values from an ini file.
| $filename | Name of ini file |
Definition at line 513 of file Config.php.
References $filename, isFinalized(), and loadArray().
Here is the call graph for this function:| HTMLPurifier_Config::mergeArrayFromForm | ( | $array, | |
$index = false, |
|||
$allowed = true, |
|||
$mq_fix = true |
|||
| ) |
Merges in configuration values from $_GET/$_POST to object.
NOT STATIC.
Definition at line 480 of file Config.php.
References $ret, loadArray(), and prepareArrayFromForm().
Here is the call graph for this function:
|
static |
Prepares an array from a form into something usable for the more strict parts of HTMLPurifier_Config.
Definition at line 489 of file Config.php.
References $key, $ret, and getAllowedDirectivesForForm().
Referenced by loadArrayFromForm(), and mergeArrayFromForm().
Here is the call graph for this function:
Here is the caller graph for this function:| HTMLPurifier_Config::serialize | ( | ) |
Returns a serialized form of the configuration object that can be reconstituted.
Definition at line 571 of file Config.php.
References getDefinition().
Referenced by getBatchSerial(), and getSerial().
Here is the call graph for this function:
Here is the caller graph for this function:| HTMLPurifier_Config::set | ( | $key, | |
| $value, | |||
$a = null |
|||
| ) |
Sets a value to configuration.
| $key | String key |
| $value | Mixed value |
Definition at line 236 of file Config.php.
References $def, $key, $namespace, $type, _listify(), HTMLPurifier_VarParser\getTypeName(), isFinalized(), and triggerError().
Here is the call graph for this function:
|
protected |
Produces a nicely formatted error message by supplying the stack frame information from two levels up and OUTSIDE of HTMLPurifier_Config.
Definition at line 555 of file Config.php.
Referenced by get(), getBatch(), isFinalized(), and set().
Here is the caller graph for this function:
|
private |
Whether or not a set is taking place due to an alias lookup.
Definition at line 75 of file Config.php.
| HTMLPurifier_Config::$autoFinalize = true |
Bool indicator whether or not to automatically finalize the object if a read operation is done.
Definition at line 29 of file Config.php.
| HTMLPurifier_Config::$chatty = true |
Set to false if you do not want line and file numbers in errors (useful when unit testing)
Definition at line 81 of file Config.php.
| HTMLPurifier_Config::$def |
Reference HTMLPurifier_ConfigSchema for value checking.
Definition at line 54 of file Config.php.
Referenced by getAllowedDirectivesForForm(), and set().
|
protected |
Indexed array of definitions.
Definition at line 59 of file Config.php.
|
protected |
Bool indicator whether or not config is finalized.
Definition at line 64 of file Config.php.
Referenced by isFinalized().
|
private |
Current lock; only gets to this namespace are allowed.
Definition at line 86 of file Config.php.
Referenced by getDefinition().
|
protected |
Parser for variables.
Definition at line 47 of file Config.php.
|
protected |
Property list containing configuration directives.
Definition at line 69 of file Config.php.
|
protected |
Serial for entire configuration object.
Definition at line 42 of file Config.php.
Referenced by getSerial().
|
protected |
Namespace indexed array of serials for specific namespaces (see getSerial() for more info).
Definition at line 37 of file Config.php.
| HTMLPurifier_Config::$version = '4.0.0' |
HTML Purifier's version.
Definition at line 23 of file Config.php.