<?php
/**
* Zend Framework
*
* LICENSE
*
* This source file is subject to the new BSD license that is bundled
* with this package in the file LICENSE.txt.
* It is also available through the world-wide-web at this URL:
* http://framework.zend.com/license/new-bsd
* If you did not receive a copy of the license and are unable to
* obtain it through the world-wide-web, please send an email
* to license@zend.com so we can send you a copy immediately.
*
* @category Zend
* @package Zend_Filter
* @copyright Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
* @version $Id: Input.php 24594 2012-01-05 21:27:01Z matthew $
*/
/**
* @see Zend_Loader
*/
require_once 'Zend/Loader.php';
/**
* @see Zend_Filter
*/
require_once 'Zend/Filter.php';
/**
* @see Zend_Validate
*/
require_once 'Zend/Validate.php';
/**
* @category Zend
* @package Zend_Filter
* @copyright Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
*/
class Zend_Filter_Input
{
const ALLOW_EMPTY = 'allowEmpty';
const BREAK_CHAIN = 'breakChainOnFailure';
const DEFAULT_VALUE = 'default';
const MESSAGES = 'messages';
const ESCAPE_FILTER = 'escapeFilter';
const FIELDS = 'fields';
const FILTER = 'filter';
const FILTER_CHAIN = 'filterChain';
const MISSING_MESSAGE = 'missingMessage';
const INPUT_NAMESPACE = 'inputNamespace';
const VALIDATOR_NAMESPACE = 'validatorNamespace';
const FILTER_NAMESPACE = 'filterNamespace';
const NOT_EMPTY_MESSAGE = 'notEmptyMessage';
const PRESENCE = 'presence';
const PRESENCE_OPTIONAL = 'optional';
const PRESENCE_REQUIRED = 'required';
const RULE = 'rule';
const RULE_WILDCARD = '*';
const VALIDATE = 'validate';
const VALIDATOR = 'validator';
const VALIDATOR_CHAIN = 'validatorChain';
const VALIDATOR_CHAIN_COUNT = 'validatorChainCount';
/**
* @var array Input data, before processing.
*/
protected $_data = array();
/**
* @var array Association of rules to filters.
*/
protected $_filterRules = array();
/**
* @var array Association of rules to validators.
*/
protected $_validatorRules = array();
/**
* @var array After processing data, this contains mapping of valid fields
* to field values.
*/
protected $_validFields = array();
/**
* @var array After processing data, this contains mapping of validation
* rules that did not pass validation to the array of messages returned
* by the validator chain.
*/
protected $_invalidMessages = array();
/**
* @var array After processing data, this contains mapping of validation
* rules that did not pass validation to the array of error identifiers
* returned by the validator chain.
*/
protected $_invalidErrors = array();
/**
* @var array After processing data, this contains mapping of validation
* rules in which some fields were missing to the array of messages
* indicating which fields were missing.
*/
protected $_missingFields = array();
/**
* @var array After processing, this contains a copy of $_data elements
* that were not mentioned in any validation rule.
*/
protected $_unknownFields = array();
/**
* @var Zend_Filter_Interface The filter object that is run on values
* returned by the getEscaped() method.
*/
protected $_defaultEscapeFilter = null;
/**
* Plugin loaders
* @var array
*/
protected $_loaders = array();
/**
* @var array Default values to use when processing filters and validators.
*/
protected $_defaults = array(
self::ALLOW_EMPTY => false,
self::BREAK_CHAIN => false,
self::ESCAPE_FILTER => 'HtmlEntities',
self::MISSING_MESSAGE => "Field '%field%' is required by rule '%rule%', but the field is missing",
self::NOT_EMPTY_MESSAGE => "You must give a non-empty value for field '%field%'",
self::PRESENCE => self::PRESENCE_OPTIONAL
);
/**
* @var boolean Set to False initially, this is set to True after the
* input data have been processed. Reset to False in setData() method.
*/
protected $_processed = false;
/**
* Translation object
* @var Zend_Translate
*/
protected $_translator;
/**
* Is translation disabled?
* @var Boolean
*/
protected $_translatorDisabled = false;
/**
* @param array $filterRules
* @param array $validatorRules
* @param array $data OPTIONAL
* @param array $options OPTIONAL
*/
public function __construct($filterRules, $validatorRules, array $data = null, array $options = null)
{
if ($options) {
$this->setOptions($options);
}
$this->_filterRules = (array) $filterRules;
$this->_validatorRules = (array) $validatorRules;
if ($data) {
$this->setData($data);
}
}
/**
* @param mixed $namespaces
* @return Zend_Filter_Input
* @deprecated since 1.5.0RC1 - use addFilterPrefixPath() or addValidatorPrefixPath instead.
*/
public function addNamespace($namespaces)
{
if (!is_array($namespaces)) {
$namespaces = array($namespaces);
}
foreach ($namespaces as $namespace) {
$prefix = $namespace;
$path = str_replace('_', DIRECTORY_SEPARATOR, $prefix);
$this->addFilterPrefixPath($prefix, $path);
$this->addValidatorPrefixPath($prefix, $path);
}
return $this;
}
/**
* Add prefix path for all elements
*
* @param string $prefix
* @param string $path
* @return Zend_Filter_Input
*/
public function addFilterPrefixPath($prefix, $path)
{
$this->getPluginLoader(self::FILTER)->addPrefixPath($prefix, $path);
return $this;
}
/**
* Add prefix path for all elements
*
* @param string $prefix
* @param string $path
* @return Zend_Filter_Input
*/
public function addValidatorPrefixPath($prefix, $path)
{
$this->getPluginLoader(self::VALIDATE)->addPrefixPath($prefix, $path);
return $this;
}
/**
* Set plugin loaders for use with decorators and elements
*
* @param Zend_Loader_PluginLoader_Interface $loader
* @param string $type 'filter' or 'validate'
* @return Zend_Filter_Input
* @throws Zend_Filter_Exception on invalid type
*/
public function setPluginLoader(Zend_Loader_PluginLoader_Interface $loader, $type)
{
$type = strtolower($type);
switch ($type) {
case self::FILTER:
case self::VALIDATE:
$this->_loaders[$type] = $loader;
return $this;
default:
require_once 'Zend/Filter/Exception.php';
throw new Zend_Filter_Exception(sprintf('Invalid type "%s" provided to setPluginLoader()', $type));
}
return $this;
}
/**
* Retrieve plugin loader for given type
*
* $type may be one of:
* - filter
* - validator
*
* If a plugin loader does not exist for the given type, defaults are
* created.
*
* @param string $type 'filter' or 'validate'
* @return Zend_Loader_PluginLoader_Interface
* @throws Zend_Filter_Exception on invalid type
*/
public function getPluginLoader($type)
{
$type = strtolower($type);
if (!isset($this->_loaders[$type])) {
switch ($type) {
case self::FILTER:
$prefixSegment = 'Zend_Filter_';
$pathSegment = 'Zend/Filter/';
break;
case self::VALIDATE:
$prefixSegment = 'Zend_Validate_';
$pathSegment = 'Zend/Validate/';
break;
default:
require_once 'Zend/Filter/Exception.php';
throw new Zend_Filter_Exception(sprintf('Invalid type "%s" provided to getPluginLoader()', $type));
}
require_once 'Zend/Loader/PluginLoader.php';
$this->_loaders[$type] = new Zend_Loader_PluginLoader(
array($prefixSegment => $pathSegment)
);
}
return $this->_loaders[$type];
}
/**
* @return array
*/
public function getMessages()
{
$this->_process();
return array_merge($this->_invalidMessages, $this->_missingFields);
}
/**
* @return array
*/
public function getErrors()
{
$this->_process();
return $this->_invalidErrors;
}
/**
* @return array
*/
public function getInvalid()
{
$this->_process();
return $this->_invalidMessages;
}
/**
* @return array
*/
public function getMissing()
{
$this->_process();
return $this->_missingFields;
}
/**
* @return array
*/
public function getUnknown()
{
$this->_process();
return $this->_unknownFields;
}
/**
* @param string $fieldName OPTIONAL
* @return mixed
*/
public function getEscaped($fieldName = null)
{
$this->_process();
$this->_getDefaultEscapeFilter();
if ($fieldName === null) {
return $this->_escapeRecursive($this->_validFields);
}
if (array_key_exists($fieldName, $this->_validFields)) {
return $this->_escapeRecursive($this->_validFields[$fieldName]);
}
return null;
}
/**
* @param mixed $value
* @return mixed
*/
protected function _escapeRecursive($data)
{
if($data === null) {
return $data;
}
if (!is_array($data)) {
return $this->_getDefaultEscapeFilter()->filter($data);
}
foreach ($data as &$element) {
$element = $this->_escapeRecursive($element);
}
return $data;
}
/**
* @param string $fieldName OPTIONAL
* @return mixed
*/
public function getUnescaped($fieldName = null)
{
$this->_process();
if ($fieldName === null) {
return $this->_validFields;
}
if (array_key_exists($fieldName, $this->_validFields)) {
return $this->_validFields[$fieldName];
}
return null;
}
/**
* @param string $fieldName
* @return mixed
*/
public function __get($fieldName)
{
return $this->getEscaped($fieldName);
}
/**
* @return boolean
*/
public function hasInvalid()
{
$this->_process();
return !(empty($this->_invalidMessages));
}
/**
* @return boolean
*/
public function hasMissing()
{
$this->_process();
return !(empty($this->_missingFields));
}
/**
* @return boolean
*/
public function hasUnknown()
{
$this->_process();
return !(empty($this->_unknownFields));
}
/**
* @return boolean
*/
public function hasValid()
{
$this->_process();
return !(empty($this->_validFields));
}
/**
* @param string $fieldName
* @return boolean
*/
public function isValid($fieldName = null)
{
$this->_process();
if ($fieldName === null) {
return !($this->hasMissing() || $this->hasInvalid());
}
return array_key_exists($fieldName, $this->_validFields);
}
/**
* @param string $fieldName
* @return boolean
*/
public function __isset($fieldName)
{
$this->_process();
return isset($this->_validFields[$fieldName]);
}
/**
* @return Zend_Filter_Input
* @throws Zend_Filter_Exception
*/
public function process()
{
$this->_process();
if ($this->hasInvalid()) {
require_once 'Zend/Filter/Exception.php';
throw new Zend_Filter_Exception("Input has invalid fields");
}
if ($this->hasMissing()) {
require_once 'Zend/Filter/Exception.php';
throw new Zend_Filter_Exception("Input has missing fields");
}
return $this;
}
/**
* @param array $data
* @return Zend_Filter_Input
*/
public function setData(array $data)
{
$this->_data = $data;
/**
* Reset to initial state
*/
$this->_validFields = array();
$this->_invalidMessages = array();
$this->_invalidErrors = array();
$this->_missingFields = array();
$this->_unknownFields = array();
$this->_processed = false;
return $this;
}
/**
* @param mixed $escapeFilter
* @return Zend_Filter_Interface
*/
public function setDefaultEscapeFilter($escapeFilter)
{
if (is_string($escapeFilter) || is_array($escapeFilter)) {
$escapeFilter = $this->_getFilter($escapeFilter);
}
if (!$escapeFilter instanceof Zend_Filter_Interface) {
require_once 'Zend/Filter/Exception.php';
throw new Zend_Filter_Exception('Escape filter specified does not implement Zend_Filter_Interface');
}
$this->_defaultEscapeFilter = $escapeFilter;
return $escapeFilter;
}
/**
* @param array $options
* @return Zend_Filter_Input
* @throws Zend_Filter_Exception if an unknown option is given
*/
public function setOptions(array $options)
{
foreach ($options as $option => $value) {
switch ($option) {
case self::ESCAPE_FILTER:
$this->setDefaultEscapeFilter($value);
break;
case self::INPUT_NAMESPACE:
$this->addNamespace($value);
break;
case self::VALIDATOR_NAMESPACE:
if(is_string($value)) {
$value = array($value);
}
foreach($value AS $prefix) {
$this->addValidatorPrefixPath(
$prefix,
str_replace('_', DIRECTORY_SEPARATOR, $prefix)
);
}
break;
case self::FILTER_NAMESPACE:
if(is_string($value)) {
$value = array($value);
}
foreach($value AS $prefix) {
$this->addFilterPrefixPath(
$prefix,
str_replace('_', DIRECTORY_SEPARATOR, $prefix)
);
}
break;
case self::ALLOW_EMPTY:
case self::BREAK_CHAIN:
case self::MISSING_MESSAGE:
case self::NOT_EMPTY_MESSAGE:
case self::PRESENCE:
$this->_defaults[$option] = $value;
break;
default:
require_once 'Zend/Filter/Exception.php';
throw new Zend_Filter_Exception("Unknown option '$option'");
break;
}
}
return $this;
}
/**
* Set translation object
*
* @param Zend_Translate|Zend_Translate_Adapter|null $translator
* @return Zend_Filter_Input
*/
public function setTranslator($translator = null)
{
if ((null === $translator) || ($translator instanceof Zend_Translate_Adapter)) {
$this->_translator = $translator;
} elseif ($translator instanceof Zend_Translate) {
$this->_translator = $translator->getAdapter();
} else {
require_once 'Zend/Validate/Exception.php';
throw new Zend_Validate_Exception('Invalid translator specified');
}
return $this;
}
/**
* Return translation object
*
* @return Zend_Translate_Adapter|null
*/
public function getTranslator()
{
if ($this->translatorIsDisabled()) {
return null;
}
if ($this->_translator === null) {
require_once 'Zend/Registry.php';
if (Zend_Registry::isRegistered('Zend_Translate')) {
$translator = Zend_Registry::get('Zend_Translate');
if ($translator instanceof Zend_Translate_Adapter) {
return $translator;
} elseif ($translator instanceof Zend_Translate) {
return $translator->getAdapter();
}
}
}
return $this->_translator;
}
/**
* Indicate whether or not translation should be disabled
*
* @param bool $flag
* @return Zend_Filter_Input
*/
public function setDisableTranslator($flag)
{
$this->_translatorDisabled = (bool) $flag;
return $this;
}
/**
* Is translation disabled?
*
* @return bool
*/
public function translatorIsDisabled()
{
return $this->_translatorDisabled;
}
/*
* Protected methods
*/
/**
* @return void
*/
protected function _filter()
{
foreach ($this->_filterRules as $ruleName => &$filterRule) {
/**
* Make sure we have an array representing this filter chain.
* Don't typecast to (array) because it might be a Zend_Filter object
*/
if (!is_array($filterRule)) {
$filterRule = array($filterRule);
}
/**
* Filters are indexed by integer, metacommands are indexed by string.
* Pick out the filters.
*/
$filterList = array();
foreach ($filterRule as $key => $value) {
if (is_int($key)) {
$filterList[] = $value;
}
}
/**
* Use defaults for filter metacommands.
*/
$filterRule[self::RULE] = $ruleName;
if (!isset($filterRule[self::FIELDS])) {
$filterRule[self::FIELDS] = $ruleName;
}
/**
* Load all the filter classes and add them to the chain.
*/
if (!isset($filterRule[self::FILTER_CHAIN])) {
$filterRule[self::FILTER_CHAIN] = new Zend_Filter();
foreach ($filterList as $filter) {
if (is_string($filter) || is_array($filter)) {
$filter = $this->_getFilter($filter);
}
$filterRule[self::FILTER_CHAIN]->addFilter($filter);
}
}
/**
* If the ruleName is the special wildcard rule,
* then apply the filter chain to all input data.
* Else just process the field named by the rule.
*/
if ($ruleName == self::RULE_WILDCARD) {
foreach (array_keys($this->_data) as $field) {
$this->_filterRule(array_merge($filterRule, array(self::FIELDS => $field)));
}
} else {
$this->_filterRule($filterRule);
}
}
}
/**
* @param array $filterRule
* @return void
*/
protected function _filterRule(array $filterRule)
{
$field = $filterRule[self::FIELDS];
if (!array_key_exists($field, $this->_data)) {
return;
}
if (is_array($this->_data[$field])) {
foreach ($this->_data[$field] as $key => $value) {
$this->_data[$field][$key] = $filterRule[self::FILTER_CHAIN]->filter($value);
}
} else {
$this->_data[$field] =
$filterRule[self::FILTER_CHAIN]->filter($this->_data[$field]);
}
}
/**
* @return Zend_Filter_Interface
*/
protected function _getDefaultEscapeFilter()
{
if ($this->_defaultEscapeFilter !== null) {
return $this->_defaultEscapeFilter;
}
return $this->setDefaultEscapeFilter($this->_defaults[self::ESCAPE_FILTER]);
}
/**
* @param string $rule
* @param string $field
* @return string
*/
protected function _getMissingMessage($rule, $field)
{
$message = $this->_defaults[self::MISSING_MESSAGE];
if (null !== ($translator = $this->getTranslator())) {
if ($translator->isTranslated(self::MISSING_MESSAGE)) {
$message = $translator->translate(self::MISSING_MESSAGE);
} else {
$message = $translator->translate($message);
}
}
$message = str_replace('%rule%', $rule, $message);
$message = str_replace('%field%', $field, $message);
return $message;
}
/**
* @return string
*/
protected function _getNotEmptyMessage($rule, $field)
{
$message = $this->_defaults[self::NOT_EMPTY_MESSAGE];
if (null !== ($translator = $this->getTranslator())) {
if ($translator->isTranslated(self::NOT_EMPTY_MESSAGE)) {
$message = $translator->translate(self::NOT_EMPTY_MESSAGE);
} else {
$message = $translator->translate($message);
}
}
$message = str_replace('%rule%', $rule, $message);
$message = str_replace('%field%', $field, $message);
return $message;
}
/**
* @return void
*/
protected function _process()
{
if ($this->_processed === false) {
$this->_filter();
$this->_validate();
$this->_processed = true;
}
}
/**
* @return void
*/
protected function _validate()
{
/**
* Special case: if there are no validators, treat all fields as valid.
*/
if (!$this->_validatorRules) {
$this->_validFields = $this->_data;
$this->_data = array();
return;
}
// remember the default not empty message in case we want to temporarily change it
$preserveDefaultNotEmptyMessage = $this->_defaults[self::NOT_EMPTY_MESSAGE];
foreach ($this->_validatorRules as $ruleName => &$validatorRule) {
/**
* Make sure we have an array representing this validator chain.
* Don't typecast to (array) because it might be a Zend_Validate object
*/
if (!is_array($validatorRule)) {
$validatorRule = array($validatorRule);
}
/**
* Validators are indexed by integer, metacommands are indexed by string.
* Pick out the validators.
*/
$validatorList = array();
foreach ($validatorRule as $key => $value) {
if (is_int($key)) {
$validatorList[$key] = $value;
}
}
/**
* Use defaults for validation metacommands.
*/
$validatorRule[self::RULE] = $ruleName;
if (!isset($validatorRule[self::FIELDS])) {
$validatorRule[self::FIELDS] = $ruleName;
}
if (!isset($validatorRule[self::BREAK_CHAIN])) {
$validatorRule[self::BREAK_CHAIN] = $this->_defaults[self::BREAK_CHAIN];
}
if (!isset($validatorRule[self::PRESENCE])) {
$validatorRule[self::PRESENCE] = $this->_defaults[self::PRESENCE];
}
if (!isset($validatorRule[self::ALLOW_EMPTY])) {
$foundNotEmptyValidator = false;
foreach ($validatorRule as $rule) {
if ($rule === 'NotEmpty') {
$foundNotEmptyValidator = true;
// field may not be empty, we are ready
break 1;
}
if (is_array($rule)) {
$keys = array_keys($rule);
$classKey = array_shift($keys);
if (isset($rule[$classKey])) {
$ruleClass = $rule[$classKey];
if ($ruleClass === 'NotEmpty') {
$foundNotEmptyValidator = true;
// field may not be empty, we are ready
break 1;
}
}
}
// we must check if it is an object before using instanceof
if (!is_object($rule)) {
// it cannot be a NotEmpty validator, skip this one
continue;
}
if($rule instanceof Zend_Validate_NotEmpty) {
$foundNotEmptyValidator = true;
// field may not be empty, we are ready
break 1;
}
}
if (!$foundNotEmptyValidator) {
$validatorRule[self::ALLOW_EMPTY] = $this->_defaults[self::ALLOW_EMPTY];
} else {
$validatorRule[self::ALLOW_EMPTY] = false;
}
}
if (!isset($validatorRule[self::MESSAGES])) {
$validatorRule[self::MESSAGES] = array();
} else if (!is_array($validatorRule[self::MESSAGES])) {
$validatorRule[self::MESSAGES] = array($validatorRule[self::MESSAGES]);
} else if (array_intersect_key($validatorList, $validatorRule[self::MESSAGES])) {
// this seems pointless... it just re-adds what it already has...
// I can disable all this and not a single unit test fails...
// There are now corresponding numeric keys in the validation rule messages array
// Treat it as a named messages list for all rule validators
$unifiedMessages = $validatorRule[self::MESSAGES];
$validatorRule[self::MESSAGES] = array();
foreach ($validatorList as $key => $validator) {
if (array_key_exists($key, $unifiedMessages)) {
$validatorRule[self::MESSAGES][$key] = $unifiedMessages[$key];
}
}
}
/**
* Load all the validator classes and add them to the chain.
*/
if (!isset($validatorRule[self::VALIDATOR_CHAIN])) {
$validatorRule[self::VALIDATOR_CHAIN] = new Zend_Validate();
foreach ($validatorList as $key => $validator) {
if (is_string($validator) || is_array($validator)) {
$validator = $this->_getValidator($validator);
}
if (isset($validatorRule[self::MESSAGES][$key])) {
$value = $validatorRule[self::MESSAGES][$key];
if (is_array($value)) {
$validator->setMessages($value);
} else {
$validator->setMessage($value);
}
if ($validator instanceof Zend_Validate_NotEmpty) {
/** we are changing the defaults here, this is alright if all subsequent validators are also a not empty
* validator, but it goes wrong if one of them is not AND is required!!!
* that is why we restore the default value at the end of this loop
*/
if (is_array($value)) {
$temp = $value; // keep the original value
$this->_defaults[self::NOT_EMPTY_MESSAGE] = array_pop($temp);
unset($temp);
} else {
$this->_defaults[self::NOT_EMPTY_MESSAGE] = $value;
}
}
}
$validatorRule[self::VALIDATOR_CHAIN]->addValidator($validator, $validatorRule[self::BREAK_CHAIN]);
}
$validatorRule[self::VALIDATOR_CHAIN_COUNT] = count($validatorList);
}
/**
* If the ruleName is the special wildcard rule,
* then apply the validator chain to all input data.
* Else just process the field named by the rule.
*/
if ($ruleName == self::RULE_WILDCARD) {
foreach (array_keys($this->_data) as $field) {
$this->_validateRule(array_merge($validatorRule, array(self::FIELDS => $field)));
}
} else {
$this->_validateRule($validatorRule);
}
// reset the default not empty message
$this->_defaults[self::NOT_EMPTY_MESSAGE] = $preserveDefaultNotEmptyMessage;
}
/**
* Unset fields in $_data that have been added to other arrays.
* We have to wait until all rules have been processed because
* a given field may be referenced by multiple rules.
*/
foreach (array_merge(array_keys($this->_missingFields), array_keys($this->_invalidMessages)) as $rule) {
foreach ((array) $this->_validatorRules[$rule][self::FIELDS] as $field) {
unset($this->_data[$field]);
}
}
foreach ($this->_validFields as $field => $value) {
unset($this->_data[$field]);
}
/**
* Anything left over in $_data is an unknown field.
*/
$this->_unknownFields = $this->_data;
}
/**
* @param array $validatorRule
* @return void
*/
protected function _validateRule(array $validatorRule)
{
/**
* Get one or more data values from input, and check for missing fields.
* Apply defaults if fields are missing.
*/
$data = array();
foreach ((array) $validatorRule[self::FIELDS] as $key => $field) {
if (array_key_exists($field, $this->_data)) {
$data[$field] = $this->_data[$field];
} else if (isset($validatorRule[self::DEFAULT_VALUE])) {
/** @todo according to this code default value can't be an array. It has to be reviewed */
if (!is_array($validatorRule[self::DEFAULT_VALUE])) {
// Default value is a scalar
$data[$field] = $validatorRule[self::DEFAULT_VALUE];
} else {
// Default value is an array. Search for corresponding key
if (isset($validatorRule[self::DEFAULT_VALUE][$key])) {
$data[$field] = $validatorRule[self::DEFAULT_VALUE][$key];
} else if ($validatorRule[self::PRESENCE] == self::PRESENCE_REQUIRED) {
// Default value array is provided, but it doesn't have an entry for current field
// and presence is required
$this->_missingFields[$validatorRule[self::RULE]][] =
$this->_getMissingMessage($validatorRule[self::RULE], $field);
}
}
} else if ($validatorRule[self::PRESENCE] == self::PRESENCE_REQUIRED) {
$this->_missingFields[$validatorRule[self::RULE]][] =
$this->_getMissingMessage($validatorRule[self::RULE], $field);
}
}
/**
* If any required fields are missing, break the loop.
*/
if (isset($this->_missingFields[$validatorRule[self::RULE]]) && count($this->_missingFields[$validatorRule[self::RULE]]) > 0) {
return;
}
/**
* Evaluate the inputs against the validator chain.
*/
if (count((array) $validatorRule[self::FIELDS]) > 1) {
if (!$validatorRule[self::ALLOW_EMPTY]) {
$emptyFieldsFound = false;
$errorsList = array();
$messages = array();
foreach ($data as $fieldKey => $field) {
// if there is no Zend_Validate_NotEmpty instance in the rules, we will use the default
if (!($notEmptyValidator = $this->_getNotEmptyValidatorInstance($validatorRule))) {
$notEmptyValidator = $this->_getValidator('NotEmpty');
$notEmptyValidator->setMessage($this->_getNotEmptyMessage($validatorRule[self::RULE], $fieldKey));
}
if (!$notEmptyValidator->isValid($field)) {
foreach ($notEmptyValidator->getMessages() as $messageKey => $message) {
if (!isset($messages[$messageKey])) {
$messages[$messageKey] = $message;
} else {
$messages[] = $message;
}
}
$errorsList[] = $notEmptyValidator->getErrors();
$emptyFieldsFound = true;
}
}
if ($emptyFieldsFound) {
$this->_invalidMessages[$validatorRule[self::RULE]] = $messages;
$this->_invalidErrors[$validatorRule[self::RULE]] = array_unique(call_user_func_array('array_merge', $errorsList));
return;
}
}
if (!$validatorRule[self::VALIDATOR_CHAIN]->isValid($data)) {
$this->_invalidMessages[$validatorRule[self::RULE]] = $validatorRule[self::VALIDATOR_CHAIN]->getMessages();
$this->_invalidErrors[$validatorRule[self::RULE]] = $validatorRule[self::VALIDATOR_CHAIN]->getErrors();
return;
}
} else if (count($data) > 0) {
// $data is actually a one element array
$fieldNames = array_keys($data);
$fieldName = reset($fieldNames);
$field = reset($data);
$failed = false;
if (!is_array($field)) {
$field = array($field);
}
// if there is no Zend_Validate_NotEmpty instance in the rules, we will use the default
if (!($notEmptyValidator = $this->_getNotEmptyValidatorInstance($validatorRule))) {
$notEmptyValidator = $this->_getValidator('NotEmpty');
$notEmptyValidator->setMessage($this->_getNotEmptyMessage($validatorRule[self::RULE], $fieldName));
}
if ($validatorRule[self::ALLOW_EMPTY]) {
$validatorChain = $validatorRule[self::VALIDATOR_CHAIN];
} else {
$validatorChain = new Zend_Validate();
$validatorChain->addValidator($notEmptyValidator, true /* Always break on failure */);
$validatorChain->addValidator($validatorRule[self::VALIDATOR_CHAIN]);
}
foreach ($field as $key => $value) {
if ($validatorRule[self::ALLOW_EMPTY] && !$notEmptyValidator->isValid($value)) {
// Field is empty AND it's allowed. Do nothing.
continue;
}
if (!$validatorChain->isValid($value)) {
if (isset($this->_invalidMessages[$validatorRule[self::RULE]])) {
$collectedMessages = $this->_invalidMessages[$validatorRule[self::RULE]];
} else {
$collectedMessages = array();
}
foreach ($validatorChain->getMessages() as $messageKey => $message) {
if (!isset($collectedMessages[$messageKey])) {
$collectedMessages[$messageKey] = $message;
} else {
$collectedMessages[] = $message;
}
}
$this->_invalidMessages[$validatorRule[self::RULE]] = $collectedMessages;
if (isset($this->_invalidErrors[$validatorRule[self::RULE]])) {
$this->_invalidErrors[$validatorRule[self::RULE]] = array_merge($this->_invalidErrors[$validatorRule[self::RULE]],
$validatorChain->getErrors());
} else {
$this->_invalidErrors[$validatorRule[self::RULE]] = $validatorChain->getErrors();
}
unset($this->_validFields[$fieldName]);
$failed = true;
if ($validatorRule[self::BREAK_CHAIN]) {
return;
}
}
}
if ($failed) {
return;
}
}
/**
* If we got this far, the inputs for this rule pass validation.
*/
foreach ((array) $validatorRule[self::FIELDS] as $field) {
if (array_key_exists($field, $data)) {
$this->_validFields[$field] = $data[$field];
}
}
}
/**
* Check a validatorRule for the presence of a NotEmpty validator instance.
* The purpose is to preserve things like a custom message, that may have been
* set on the validator outside Zend_Filter_Input.
* @param array $validatorRule
* @return mixed false if none is found, Zend_Validate_NotEmpty instance if found
*/
protected function _getNotEmptyValidatorInstance($validatorRule) {
foreach ($validatorRule as $rule => $value) {
if (is_object($value) and $value instanceof Zend_Validate_NotEmpty) {
return $value;
}
}
return false;
}
/**
* @param mixed $classBaseName
* @return Zend_Filter_Interface
*/
protected function _getFilter($classBaseName)
{
return $this->_getFilterOrValidator(self::FILTER, $classBaseName);
}
/**
* @param mixed $classBaseName
* @return Zend_Validate_Interface
*/
protected function _getValidator($classBaseName)
{
return $this->_getFilterOrValidator(self::VALIDATE, $classBaseName);
}
/**
* @param string $type
* @param mixed $classBaseName
* @return Zend_Filter_Interface|Zend_Validate_Interface
* @throws Zend_Filter_Exception
*/
protected function _getFilterOrValidator($type, $classBaseName)
{
$args = array();
if (is_array($classBaseName)) {
$args = $classBaseName;
$classBaseName = array_shift($args);
}
$interfaceName = 'Zend_' . ucfirst($type) . '_Interface';
$className = $this->getPluginLoader($type)->load(ucfirst($classBaseName));
$class = new ReflectionClass($className);
if (!$class->implementsInterface($interfaceName)) {
require_once 'Zend/Filter/Exception.php';
throw new Zend_Filter_Exception("Class '$className' based on basename '$classBaseName' must implement the '$interfaceName' interface");
}
if ($class->hasMethod('__construct')) {
$object = $class->newInstanceArgs($args);
} else {
$object = $class->newInstance();
}
return $object;
}
}