/**
* Creates a filter object from the filter directories.
*
* @param string $filterName
* @return mixed
* @throws PIECE_RIGHT_ERROR_NOT_FOUND
* @throws PIECE_RIGHT_ERROR_CANNOT_READ
*/
function &factory($filterName)
{
if (!array_key_exists($filterName, $GLOBALS['PIECE_RIGHT_Filter_Instances'])) {
$found = false;
foreach ($GLOBALS['PIECE_RIGHT_Filter_Prefixes'] as $prefixAlias) {
$filterClass = Piece_Right_Filter_Factory::_getFilterClass($filterName, $prefixAlias);
if (Piece_Right_ClassLoader::loaded($filterClass)) {
$found = true;
break;
}
}
if (!$found) {
foreach ($GLOBALS['PIECE_RIGHT_Filter_Directories'] as $filterDirectory) {
foreach ($GLOBALS['PIECE_RIGHT_Filter_Prefixes'] as $prefixAlias) {
$filterClass = Piece_Right_Filter_Factory::_getFilterClass($filterName, $prefixAlias);
Piece_Right_Error::disableCallback();
Piece_Right_ClassLoader::load($filterClass, $filterDirectory);
Piece_Right_Error::enableCallback();
if (Piece_Right_Error::hasErrors()) {
$error = Piece_Right_Error::pop();
if ($error['code'] == PIECE_RIGHT_ERROR_NOT_FOUND) {
continue;
}
Piece_Right_Error::push(PIECE_RIGHT_ERROR_CANNOT_READ, "Failed to read the filter [ {$filterName} ] for any reasons.", 'exception', array(), $error);
$return = null;
return $return;
}
if (Piece_Right_ClassLoader::loaded($filterClass)) {
$found = true;
break 2;
}
}
}
if (!$found) {
Piece_Right_Error::push(PIECE_RIGHT_ERROR_NOT_FOUND, "The filter [ {$filterName} ] is not found in the following directories:\n" . implode("\n", $GLOBALS['PIECE_RIGHT_Filter_Directories']));
$return = null;
return $return;
}
}
$GLOBALS['PIECE_RIGHT_Filter_Instances'][$filterName] =& new $filterClass();
}
return $GLOBALS['PIECE_RIGHT_Filter_Instances'][$filterName];
}
