ILIAS
Release_4_0_x_branch Revision 61816
|
Configuration object that triggers customizable behavior. More...
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().
|
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().
|
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().
HTMLPurifier_Config::finalize | ( | ) |
Finalizes a configuration object, prohibiting further change.
Definition at line 545 of file Config.php.
Referenced by autoFinalize().
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().
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().
|
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().
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().
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().
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().
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().
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().
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().
|
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().
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().
|
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().
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().
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().
|
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().
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().
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().
|
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().
|
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.