mirror/php-htmlpurifier
1
0
Fork 0
mirror of https://github.com/ezyang/htmlpurifier.git synced 2025-08-03 20:58:11 +02:00
Code Issues Releases Wiki Activity

Refactor VarParser and VarParser_Flexible to use template method, factoring out common functionality.

Browse Source 
git-svn-id: http://htmlpurifier.org/svnroot/htmlpurifier/trunk@1603 48356398-32a2-884e-a903-53898d9a118a
This commit is contained in:
Edward Z. Yang
2008-03-05 04:41:45 +00:00
parent bd64a8346d
commit ff60e09780
2 changed files with 83 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

81
library/HTMLPurifier/VarParser.php
View File

@@ -2,9 +2,9 @@
/**
* Parses string representations into their corresponding native PHP
* variable type.
* variable type. The base implementation does a simple type-check.
*/
abstract class HTMLPurifier_VarParser
class HTMLPurifier_VarParser
{
/**
@@ -34,6 +34,81 @@ abstract class HTMLPurifier_VarParser
* @param $allow_null Whether or not to permit null as a value
* @return Validated and type-coerced variable
*/
abstract public function parse($var, $type, $allow_null = false);
final public function parse($var, $type, $allow_null = false) {
if (!isset(HTMLPurifier_VarParser::$types[$type])) {
throw new HTMLPurifier_VarParserException("Invalid type $type");
}
$var = $this->parseImplementation($var, $type, $allow_null);
if ($allow_null && $var === null) return null;
// These are basic checks, to make sure nothing horribly wrong
// happened in our implementations.
switch ($type) {
case 'string':
case 'istring':
case 'text':
case 'itext':
if (!is_string($var)) break;
if ($type[0] == 'i') $var = strtolower($var);
return $var;
case 'int':
if (!is_int($var)) break;
return $var;
case 'float':
if (!is_float($var)) break;
return $var;
case 'bool':
if (!is_bool($var)) break;
return $var;
case 'lookup':
case 'list':
case 'hash':
if (!is_array($var)) break;
if ($type === 'lookup') {
foreach ($var as $k) if ($k !== true) $this->error('Lookup table contains value other than true');
} elseif ($type === 'list') {
$keys = array_keys($var);
if (array_keys($keys) !== $keys) $this->error('Indices for list are not uniform');
}
return $var;
case 'mixed':
return $var;
default:
$this->errorInconsistent(__CLASS__, $type);
}
$this->errorGeneric($var, $type);
}
/**
* Actually implements the parsing. Base implementation is to not
* do anything to $var. Subclasses should overload this!
*/
protected function parseImplementation($var, $type, $allow_null) {
return $var;
}
/**
* Throws an exception.
*/
protected function error($msg) {
throw new HTMLPurifier_VarParserException($msg);
}
/**
* Throws an inconsistency exception.
* @note This should not ever be called. It would be called if we
* extend the allowed values of HTMLPurifier_VarParser without
* updating subclasses.
*/
protected function errorInconsistent($class, $type) {
throw new HTMLPurifier_Exception("Inconsistency in $class: $type not implemented");
}
/**
* Generic error for if a type didn't work.
*/
protected function errorGeneric($var, $type) {
$vtype = gettype($var);
$this->error("Expected type $type, got $vtype");
}
}