HTMLPurifier_HTMLModuleManager::setup() - Code Metrics - Inspection of "Web: update scrutinizer settings" - BOINC/boinc - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( eb6d5e...9d1a7a )

by Christian

created 2017-03-10 14:57 UTC

HTMLPurifier_HTMLModuleManager::setup() F

↳ Parent: Project

Complexity

Conditions	19
Paths	8192

Size

Total Lines	93
Code Lines	49

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	19
eloc	49
nc	8192
nop	1
dl	0
loc	93
rs	2
c	0
b	0
f	0

How to fix Long Method Complexity

<?php

class HTMLPurifier_HTMLModuleManager
{

    /**
     * @type HTMLPurifier_DoctypeRegistry
     */
    public $doctypes;

    /**
     * Instance of current doctype.
     * @type string
     */
    public $doctype;

    /**
     * @type HTMLPurifier_AttrTypes
     */
    public $attrTypes;

    /**
     * Active instances of modules for the specified doctype are
     * indexed, by name, in this array.
     * @type HTMLPurifier_HTMLModule[]
     */
    public $modules = array();

    /**
     * Array of recognized HTMLPurifier_HTMLModule instances,
     * indexed by module's class name. This array is usually lazy loaded, but a
     * user can overload a module by pre-emptively registering it.
     * @type HTMLPurifier_HTMLModule[]
     */
    public $registeredModules = array();

    /**
     * List of extra modules that were added by the user
     * using addModule(). These get unconditionally merged into the current doctype, whatever
     * it may be.
     * @type HTMLPurifier_HTMLModule[]
     */
    public $userModules = array();

    /**
     * Associative array of element name to list of modules that have
     * definitions for the element; this array is dynamically filled.
     * @type array
     */
    public $elementLookup = array();

    /**
     * List of prefixes we should use for registering small names.
     * @type array
     */
    public $prefixes = array('HTMLPurifier_HTMLModule_');

    /**
     * @type HTMLPurifier_ContentSets
     */
    public $contentSets;

    /**
     * @type HTMLPurifier_AttrCollections
     */
    public $attrCollections;

    /**
     * If set to true, unsafe elements and attributes will be allowed.
     * @type bool
     */
    public $trusted = false;

    public function __construct()
    {
        // editable internal objects
        $this->attrTypes = new HTMLPurifier_AttrTypes();
        $this->doctypes  = new HTMLPurifier_DoctypeRegistry();

        // setup basic modules
        $common = array(
            'CommonAttributes', 'Text', 'Hypertext', 'List',
            'Presentation', 'Edit', 'Bdo', 'Tables', 'Image',
            'StyleAttribute',
            // Unsafe:
            'Scripting', 'Object', 'Forms',
            // Sorta legacy, but present in strict:
            'Name',
        );
        $transitional = array('Legacy', 'Target', 'Iframe');
        $xml = array('XMLCommonAttributes');
        $non_xml = array('NonXMLCommonAttributes');

        // setup basic doctypes
        $this->doctypes->register(
            'HTML 4.01 Transitional',
            false,
            array_merge($common, $transitional, $non_xml),
            array('Tidy_Transitional', 'Tidy_Proprietary'),
            array(),
            '-//W3C//DTD HTML 4.01 Transitional//EN',
            'http://www.w3.org/TR/html4/loose.dtd'
        );

        $this->doctypes->register(
            'HTML 4.01 Strict',
            false,
            array_merge($common, $non_xml),
            array('Tidy_Strict', 'Tidy_Proprietary', 'Tidy_Name'),
            array(),
            '-//W3C//DTD HTML 4.01//EN',
            'http://www.w3.org/TR/html4/strict.dtd'
        );

        $this->doctypes->register(
            'XHTML 1.0 Transitional',
            true,
            array_merge($common, $transitional, $xml, $non_xml),
            array('Tidy_Transitional', 'Tidy_XHTML', 'Tidy_Proprietary', 'Tidy_Name'),
            array(),
            '-//W3C//DTD XHTML 1.0 Transitional//EN',
            'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'
        );

        $this->doctypes->register(
            'XHTML 1.0 Strict',
            true,
            array_merge($common, $xml, $non_xml),
            array('Tidy_Strict', 'Tidy_XHTML', 'Tidy_Strict', 'Tidy_Proprietary', 'Tidy_Name'),
            array(),
            '-//W3C//DTD XHTML 1.0 Strict//EN',
            'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'
        );

        $this->doctypes->register(
            'XHTML 1.1',
            true,
            // Iframe is a real XHTML 1.1 module, despite being
            // "transitional"!
            array_merge($common, $xml, array('Ruby', 'Iframe')),
            array('Tidy_Strict', 'Tidy_XHTML', 'Tidy_Proprietary', 'Tidy_Strict', 'Tidy_Name'), // Tidy_XHTML1_1
            array(),
            '-//W3C//DTD XHTML 1.1//EN',
            'http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd'
        );

    }

    /**
     * Registers a module to the recognized module list, useful for
     * overloading pre-existing modules.
     * @param $module Mixed: string module name, with or without
     *                HTMLPurifier_HTMLModule prefix, or instance of
     *                subclass of HTMLPurifier_HTMLModule.
     * @param $overload Boolean whether or not to overload previous modules.
     *                  If this is not set, and you do overload a module,
     *                  HTML Purifier will complain with a warning.
     * @note This function will not call autoload, you must instantiate
     *       (and thus invoke) autoload outside the method.
     * @note If a string is passed as a module name, different variants
     *       will be tested in this order:
     *          - Check for HTMLPurifier_HTMLModule_$name
     *          - Check all prefixes with $name in order they were added
     *          - Check for literal object name
     *          - Throw fatal error
     *       If your object name collides with an internal class, specify
     *       your module manually. All modules must have been included
     *       externally: registerModule will not perform inclusions for you!
     */
    public function registerModule($module, $overload = false)
    {
        if (is_string($module)) {
            // attempt to load the module
            $original_module = $module;
            $ok = false;
            foreach ($this->prefixes as $prefix) {
                $module = $prefix . $original_module;
                if (class_exists($module)) {
                    $ok = true;
                    break;
                }
            }
            if (!$ok) {
                $module = $original_module;
                if (!class_exists($module)) {
                    trigger_error(
                        $original_module . ' module does not exist',
                        E_USER_ERROR
                    );
                    return;
                }
            }
            $module = new $module();
        }
        if (empty($module->name)) {
            trigger_error('Module instance of ' . get_class($module) . ' must have name');
            return;
        }
        if (!$overload && isset($this->registeredModules[$module->name])) {
            trigger_error('Overloading ' . $module->name . ' without explicit overload parameter', E_USER_WARNING);
        }
        $this->registeredModules[$module->name] = $module;
    }

    /**
     * Adds a module to the current doctype by first registering it,
     * and then tacking it on to the active doctype
     */
    public function addModule($module)
    {
        $this->registerModule($module);
        if (is_object($module)) {
            $module = $module->name;
        }
        $this->userModules[] = $module;
    }

    /**
     * Adds a class prefix that registerModule() will use to resolve a
     * string name to a concrete class
     */
    public function addPrefix($prefix)
    {
        $this->prefixes[] = $prefix;
    }

    /**
     * Performs processing on modules, after being called you may
     * use getElement() and getElements()
     * @param HTMLPurifier_Config $config
     */
    public function setup($config)
    {
        $this->trusted = $config->get('HTML.Trusted');

        // generate
        $this->doctype = $this->doctypes->make($config);
        $modules = $this->doctype->modules;

        // take out the default modules that aren't allowed
        $lookup = $config->get('HTML.AllowedModules');
        $special_cases = $config->get('HTML.CoreModules');

        if (is_array($lookup)) {
            foreach ($modules as $k => $m) {
                if (isset($special_cases[$m])) {
                    continue;
                }
                if (!isset($lookup[$m])) {
                    unset($modules[$k]);
                }
            }
        }

        // custom modules
        if ($config->get('HTML.Proprietary')) {
            $modules[] = 'Proprietary';
        }
        if ($config->get('HTML.SafeObject')) {
            $modules[] = 'SafeObject';
        }
        if ($config->get('HTML.SafeEmbed')) {
            $modules[] = 'SafeEmbed';
        }
        if ($config->get('HTML.SafeScripting') !== array()) {
            $modules[] = 'SafeScripting';
        }
        if ($config->get('HTML.Nofollow')) {
            $modules[] = 'Nofollow';
        }
        if ($config->get('HTML.TargetBlank')) {
            $modules[] = 'TargetBlank';
        }

        // merge in custom modules
        $modules = array_merge($modules, $this->userModules);

        foreach ($modules as $module) {
            $this->processModule($module);
            $this->modules[$module]->setup($config);
        }

        foreach ($this->doctype->tidyModules as $module) {
            $this->processModule($module);
            $this->modules[$module]->setup($config);
        }

        // prepare any injectors
        foreach ($this->modules as $module) {
            $n = array();
            foreach ($module->info_injector as $injector) {
                if (!is_object($injector)) {
                    $class = "HTMLPurifier_Injector_$injector";
                    $injector = new $class;
                }
                $n[$injector->name] = $injector;
            }
            $module->info_injector = $n;
        }

        // setup lookup table based on all valid modules
        foreach ($this->modules as $module) {
            foreach ($module->info as $name => $def) {
                if (!isset($this->elementLookup[$name])) {
                    $this->elementLookup[$name] = array();
                }
                $this->elementLookup[$name][] = $module->name;
            }
        }

        // note the different choice
        $this->contentSets = new HTMLPurifier_ContentSets(
            // content set assembly deals with all possible modules,
            // not just ones deemed to be "safe"
            $this->modules
        );
        $this->attrCollections = new HTMLPurifier_AttrCollections(
            $this->attrTypes,
            // there is no way to directly disable a global attribute,
            // but using AllowedAttributes or simply not including
            // the module in your custom doctype should be sufficient
            $this->modules
        );
    }

    /**
     * Takes a module and adds it to the active module collection,
     * registering it if necessary.
     */
    public function processModule($module)
    {
        if (!isset($this->registeredModules[$module]) || is_object($module)) {
            $this->registerModule($module);
        }
        $this->modules[$module] = $this->registeredModules[$module];
    }

    /**
     * Retrieves merged element definitions.
     * @return Array of HTMLPurifier_ElementDef
     */
    public function getElements()
    {
        $elements = array();
        foreach ($this->modules as $module) {
            if (!$this->trusted && !$module->safe) {
                continue;
            }
            foreach ($module->info as $name => $v) {
                if (isset($elements[$name])) {
                    continue;
                }
                $elements[$name] = $this->getElement($name);
            }
        }

        // remove dud elements, this happens when an element that
        // appeared to be safe actually wasn't
        foreach ($elements as $n => $v) {
            if ($v === false) {
                unset($elements[$n]);
            }
        }

        return $elements;

    }

    /**
     * Retrieves a single merged element definition
     * @param string $name Name of element
     * @param bool $trusted Boolean trusted overriding parameter: set to true
     *                 if you want the full version of an element
     * @return HTMLPurifier_ElementDef Merged HTMLPurifier_ElementDef
     * @note You may notice that modules are getting iterated over twice (once
     *       in getElements() and once here). This
     *       is because
     */
    public function getElement($name, $trusted = null)
    {
        if (!isset($this->elementLookup[$name])) {
            return false;
        }

        // setup global state variables
        $def = false;
        if ($trusted === null) {
            $trusted = $this->trusted;
        }

        // iterate through each module that has registered itself to this
        // element
        foreach ($this->elementLookup[$name] as $module_name) {
            $module = $this->modules[$module_name];

            // refuse to create/merge from a module that is deemed unsafe--
            // pretend the module doesn't exist--when trusted mode is not on.
            if (!$trusted && !$module->safe) {
                continue;
            }

            // clone is used because, ideally speaking, the original
            // definition should not be modified. Usually, this will
            // make no difference, but for consistency's sake
            $new_def = clone $module->info[$name];

            if (!$def && $new_def->standalone) {
                $def = $new_def;
            } elseif ($def) {
                // This will occur even if $new_def is standalone. In practice,
                // this will usually result in a full replacement.
                $def->mergeIn($new_def);
            } else {
                // :TODO:
                // non-standalone definitions that don't have a standalone
                // to merge into could be deferred to the end
                // HOWEVER, it is perfectly valid for a non-standalone
                // definition to lack a standalone definition, even
                // after all processing: this allows us to safely
                // specify extra attributes for elements that may not be
                // enabled all in one place.  In particular, this might
                // be the case for trusted elements.  WARNING: care must
                // be taken that the /extra/ definitions are all safe.
                continue;
            }

            // attribute value expansions
            $this->attrCollections->performInclusions($def->attr);
            $this->attrCollections->expandIdentifiers($def->attr, $this->attrTypes);

            // descendants_are_inline, for ChildDef_Chameleon
            if (is_string($def->content_model) &&
                strpos($def->content_model, 'Inline') !== false) {
                if ($name != 'del' && $name != 'ins') {
                    // this is for you, ins/del
                    $def->descendants_are_inline = true;
                }
            }

            $this->contentSets->generateChildDef($def, $module);
        }

        // This can occur if there is a blank definition, but no base to
        // mix it in with
        if (!$def) {
            return false;
        }

        // add information on required attributes
        foreach ($def->attr as $attr_name => $attr_def) {
            if ($attr_def->required) {
                $def->required_attr[] = $attr_name;
            }
        }
        return $def;
    }
}

// vim: et sw=4 sts=4


1			<?php
2
3			class HTMLPurifier_HTMLModuleManager
4			{
5
6			/**
7			* @type HTMLPurifier_DoctypeRegistry
8			*/
9			public $doctypes;
10
11			/**
12			* Instance of current doctype.
13			* @type string
14			*/
15			public $doctype;
16
17			/**
18			* @type HTMLPurifier_AttrTypes
19			*/
20			public $attrTypes;
21
22			/**
23			* Active instances of modules for the specified doctype are
24			* indexed, by name, in this array.
25			* @type HTMLPurifier_HTMLModule[]
26			*/
27			public $modules = array();
28
29			/**
30			* Array of recognized HTMLPurifier_HTMLModule instances,
31			* indexed by module's class name. This array is usually lazy loaded, but a
32			* user can overload a module by pre-emptively registering it.
33			* @type HTMLPurifier_HTMLModule[]
34			*/
35			public $registeredModules = array();
36
37			/**
38			* List of extra modules that were added by the user
39			* using addModule(). These get unconditionally merged into the current doctype, whatever
40			* it may be.
41			* @type HTMLPurifier_HTMLModule[]
42			*/
43			public $userModules = array();
44
45			/**
46			* Associative array of element name to list of modules that have
47			* definitions for the element; this array is dynamically filled.
48			* @type array
49			*/
50			public $elementLookup = array();
51
52			/**
53			* List of prefixes we should use for registering small names.
54			* @type array
55			*/
56			public $prefixes = array('HTMLPurifier_HTMLModule_');
57
58			/**
59			* @type HTMLPurifier_ContentSets
60			*/
61			public $contentSets;
62
63			/**
64			* @type HTMLPurifier_AttrCollections
65			*/
66			public $attrCollections;
67
68			/**
69			* If set to true, unsafe elements and attributes will be allowed.
70			* @type bool
71			*/
72			public $trusted = false;
73
74			public function __construct()
75			{
76			// editable internal objects
77			$this->attrTypes = new HTMLPurifier_AttrTypes();
78			$this->doctypes = new HTMLPurifier_DoctypeRegistry();
79
80			// setup basic modules
81			$common = array(
82			'CommonAttributes', 'Text', 'Hypertext', 'List',
83			'Presentation', 'Edit', 'Bdo', 'Tables', 'Image',
84			'StyleAttribute',
85			// Unsafe:
86			'Scripting', 'Object', 'Forms',
87			// Sorta legacy, but present in strict:
88			'Name',
89			);
90			$transitional = array('Legacy', 'Target', 'Iframe');
91			$xml = array('XMLCommonAttributes');
92			$non_xml = array('NonXMLCommonAttributes');
93
94			// setup basic doctypes
95			$this->doctypes->register(
96			'HTML 4.01 Transitional',
97			false,
98			array_merge($common, $transitional, $non_xml),
99			array('Tidy_Transitional', 'Tidy_Proprietary'),
100			array(),
101			'-//W3C//DTD HTML 4.01 Transitional//EN',
102			'http://www.w3.org/TR/html4/loose.dtd'
103			);
104
105			$this->doctypes->register(
106			'HTML 4.01 Strict',
107			false,
108			array_merge($common, $non_xml),
109			array('Tidy_Strict', 'Tidy_Proprietary', 'Tidy_Name'),
110			array(),
111			'-//W3C//DTD HTML 4.01//EN',
112			'http://www.w3.org/TR/html4/strict.dtd'
113			);
114
115			$this->doctypes->register(
116			'XHTML 1.0 Transitional',
117			true,
118			array_merge($common, $transitional, $xml, $non_xml),
119			array('Tidy_Transitional', 'Tidy_XHTML', 'Tidy_Proprietary', 'Tidy_Name'),
120			array(),
121			'-//W3C//DTD XHTML 1.0 Transitional//EN',
122			'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'
123			);
124
125			$this->doctypes->register(
126			'XHTML 1.0 Strict',
127			true,
128			array_merge($common, $xml, $non_xml),
129			array('Tidy_Strict', 'Tidy_XHTML', 'Tidy_Strict', 'Tidy_Proprietary', 'Tidy_Name'),
130			array(),
131			'-//W3C//DTD XHTML 1.0 Strict//EN',
132			'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'
133			);
134
135			$this->doctypes->register(
136			'XHTML 1.1',
137			true,
138			// Iframe is a real XHTML 1.1 module, despite being
139			// "transitional"!
140			array_merge($common, $xml, array('Ruby', 'Iframe')),
141			array('Tidy_Strict', 'Tidy_XHTML', 'Tidy_Proprietary', 'Tidy_Strict', 'Tidy_Name'), // Tidy_XHTML1_1
142			array(),
143			'-//W3C//DTD XHTML 1.1//EN',
144			'http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd'
145			);
146
147			}
148
149			/**
150			* Registers a module to the recognized module list, useful for
151			* overloading pre-existing modules.
152			* @param $module Mixed: string module name, with or without
153			* HTMLPurifier_HTMLModule prefix, or instance of
154			* subclass of HTMLPurifier_HTMLModule.
155			* @param $overload Boolean whether or not to overload previous modules.
156			* If this is not set, and you do overload a module,
157			* HTML Purifier will complain with a warning.
158			* @note This function will not call autoload, you must instantiate
159			* (and thus invoke) autoload outside the method.
160			* @note If a string is passed as a module name, different variants
161			* will be tested in this order:
162			* - Check for HTMLPurifier_HTMLModule_$name
163			* - Check all prefixes with $name in order they were added
164			* - Check for literal object name
165			* - Throw fatal error
166			* If your object name collides with an internal class, specify
167			* your module manually. All modules must have been included
168			* externally: registerModule will not perform inclusions for you!
169			*/
170			public function registerModule($module, $overload = false)
171			{
172			if (is_string($module)) {
173			// attempt to load the module
174			$original_module = $module;
175			$ok = false;
176			foreach ($this->prefixes as $prefix) {
177			$module = $prefix . $original_module;
178			if (class_exists($module)) {
179			$ok = true;
180			break;
181			}
182			}
183			if (!$ok) {
184			$module = $original_module;
185			if (!class_exists($module)) {
186			trigger_error(
187			$original_module . ' module does not exist',
188			E_USER_ERROR
189			);
190			return;
191			}
192			}
193			$module = new $module();
194			}
195			if (empty($module->name)) {
196			trigger_error('Module instance of ' . get_class($module) . ' must have name');
197			return;
198			}
199			if (!$overload && isset($this->registeredModules[$module->name])) {
200			trigger_error('Overloading ' . $module->name . ' without explicit overload parameter', E_USER_WARNING);
201			}
202			$this->registeredModules[$module->name] = $module;
203			}
204
205			/**
206			* Adds a module to the current doctype by first registering it,
207			* and then tacking it on to the active doctype
208			*/
209			public function addModule($module)
210			{
211			$this->registerModule($module);
212			if (is_object($module)) {
213			$module = $module->name;
214			}
215			$this->userModules[] = $module;
216			}
217
218			/**
219			* Adds a class prefix that registerModule() will use to resolve a
220			* string name to a concrete class
221			*/
222			public function addPrefix($prefix)
223			{
224			$this->prefixes[] = $prefix;
225			}
226
227			/**
228			* Performs processing on modules, after being called you may
229			* use getElement() and getElements()
230			* @param HTMLPurifier_Config $config
231			*/
232			public function setup($config)
233			{
234			$this->trusted = $config->get('HTML.Trusted');
235
236			// generate
237			$this->doctype = $this->doctypes->make($config);
238			$modules = $this->doctype->modules;
239
240			// take out the default modules that aren't allowed
241			$lookup = $config->get('HTML.AllowedModules');
242			$special_cases = $config->get('HTML.CoreModules');
243
244			if (is_array($lookup)) {
245			foreach ($modules as $k => $m) {
246			if (isset($special_cases[$m])) {
247			continue;
248			}
249			if (!isset($lookup[$m])) {
250			unset($modules[$k]);
251			}
252			}
253			}
254
255			// custom modules
256			if ($config->get('HTML.Proprietary')) {
257			$modules[] = 'Proprietary';
258			}
259			if ($config->get('HTML.SafeObject')) {
260			$modules[] = 'SafeObject';
261			}
262			if ($config->get('HTML.SafeEmbed')) {
263			$modules[] = 'SafeEmbed';
264			}
265			if ($config->get('HTML.SafeScripting') !== array()) {
266			$modules[] = 'SafeScripting';
267			}
268			if ($config->get('HTML.Nofollow')) {
269			$modules[] = 'Nofollow';
270			}
271			if ($config->get('HTML.TargetBlank')) {
272			$modules[] = 'TargetBlank';
273			}
274
275			// merge in custom modules
276			$modules = array_merge($modules, $this->userModules);
277
278			foreach ($modules as $module) {
279			$this->processModule($module);
280			$this->modules[$module]->setup($config);
281			}
282
283			foreach ($this->doctype->tidyModules as $module) {
284			$this->processModule($module);
285			$this->modules[$module]->setup($config);
286			}
287
288			// prepare any injectors
289			foreach ($this->modules as $module) {
290			$n = array();
291			foreach ($module->info_injector as $injector) {
292			if (!is_object($injector)) {
293			$class = "HTMLPurifier_Injector_$injector";
294			$injector = new $class;
295			}
296			$n[$injector->name] = $injector;
297			}
298			$module->info_injector = $n;
299			}
300
301			// setup lookup table based on all valid modules
302			foreach ($this->modules as $module) {
303			foreach ($module->info as $name => $def) {
304			if (!isset($this->elementLookup[$name])) {
305			$this->elementLookup[$name] = array();
306			}
307			$this->elementLookup[$name][] = $module->name;
308			}
309			}
310
311			// note the different choice
312			$this->contentSets = new HTMLPurifier_ContentSets(
313			// content set assembly deals with all possible modules,
314			// not just ones deemed to be "safe"
315			$this->modules
316			);
317			$this->attrCollections = new HTMLPurifier_AttrCollections(
318			$this->attrTypes,
319			// there is no way to directly disable a global attribute,
320			// but using AllowedAttributes or simply not including
321			// the module in your custom doctype should be sufficient
322			$this->modules
323			);
324			}
325
326			/**
327			* Takes a module and adds it to the active module collection,
328			* registering it if necessary.
329			*/
330			public function processModule($module)
331			{
332			if (!isset($this->registeredModules[$module]) \|\| is_object($module)) {
333			$this->registerModule($module);
334			}
335			$this->modules[$module] = $this->registeredModules[$module];
336			}
337
338			/**
339			* Retrieves merged element definitions.
340			* @return Array of HTMLPurifier_ElementDef
341			*/
342			public function getElements()
343			{
344			$elements = array();
345			foreach ($this->modules as $module) {
346			if (!$this->trusted && !$module->safe) {
347			continue;
348			}
349			foreach ($module->info as $name => $v) {
350			if (isset($elements[$name])) {
351			continue;
352			}
353			$elements[$name] = $this->getElement($name);
354			}
355			}
356
357			// remove dud elements, this happens when an element that
358			// appeared to be safe actually wasn't
359			foreach ($elements as $n => $v) {
360			if ($v === false) {
361			unset($elements[$n]);
362			}
363			}
364
365			return $elements;
366
367			}
368
369			/**
370			* Retrieves a single merged element definition
371			* @param string $name Name of element
372			* @param bool $trusted Boolean trusted overriding parameter: set to true
373			* if you want the full version of an element
374			* @return HTMLPurifier_ElementDef Merged HTMLPurifier_ElementDef
375			* @note You may notice that modules are getting iterated over twice (once
376			* in getElements() and once here). This
377			* is because
378			*/
379			public function getElement($name, $trusted = null)
380			{
381			if (!isset($this->elementLookup[$name])) {
382			return false;
383			}
384
385			// setup global state variables
386			$def = false;
387			if ($trusted === null) {
388			$trusted = $this->trusted;
389			}
390
391			// iterate through each module that has registered itself to this
392			// element
393			foreach ($this->elementLookup[$name] as $module_name) {
394			$module = $this->modules[$module_name];
395
396			// refuse to create/merge from a module that is deemed unsafe--
397			// pretend the module doesn't exist--when trusted mode is not on.
398			if (!$trusted && !$module->safe) {
399			continue;
400			}
401
402			// clone is used because, ideally speaking, the original
403			// definition should not be modified. Usually, this will
404			// make no difference, but for consistency's sake
405			$new_def = clone $module->info[$name];
406
407			if (!$def && $new_def->standalone) {
408			$def = $new_def;
409			} elseif ($def) {
410			// This will occur even if $new_def is standalone. In practice,
411			// this will usually result in a full replacement.
412			$def->mergeIn($new_def);
413			} else {
414			// :TODO:
415			// non-standalone definitions that don't have a standalone
416			// to merge into could be deferred to the end
417			// HOWEVER, it is perfectly valid for a non-standalone
418			// definition to lack a standalone definition, even
419			// after all processing: this allows us to safely
420			// specify extra attributes for elements that may not be
421			// enabled all in one place. In particular, this might
422			// be the case for trusted elements. WARNING: care must
423			// be taken that the /extra/ definitions are all safe.
424			continue;
425			}
426
427			// attribute value expansions
428			$this->attrCollections->performInclusions($def->attr);
429			$this->attrCollections->expandIdentifiers($def->attr, $this->attrTypes);
430
431			// descendants_are_inline, for ChildDef_Chameleon
432			if (is_string($def->content_model) &&
433			strpos($def->content_model, 'Inline') !== false) {
434			if ($name != 'del' && $name != 'ins') {
435			// this is for you, ins/del
436			$def->descendants_are_inline = true;
437			}
438			}
439
440			$this->contentSets->generateChildDef($def, $module);
441			}
442
443			// This can occur if there is a blank definition, but no base to
444			// mix it in with
445			if (!$def) {
446			return false;
447			}
448
449			// add information on required attributes
450			foreach ($def->attr as $attr_name => $attr_def) {
451			if ($attr_def->required) {
452			$def->required_attr[] = $attr_name;
453			}
454			}
455			return $def;
456			}
457			}
458
459			// vim: et sw=4 sts=4
460

BOINC / boinc

Push — master ( eb6d5e...9d1a7a )

HTMLPurifier_HTMLModuleManager::setup() F

Complexity

Size

Duplication

Importance

How to fix Long Method Complexity

Long Method

Duplication Side-by-Side

Filter issues like