Validate/File/WordCount.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 [email protected] so we can send you a copy immediately.
- Category
- Zend
- Copyright
- Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
- Package
- Zend_Validate
- Version
- $Id: WordCount.php 24593 2012-01-05 20:35:02Z matthew $
\Zend_Validate_File_WordCount
Validator for counting all words in a file
- Parent(s)
- \Zend_Validate_File_Count < \Zend_Validate_Abstract
- Category
- Zend
- Copyright
- Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
Constants
TOO_MANY
= 'fileCountTooMany'- Inherited_from
- \Zend_Validate_File_Count::TOO_MANY
TOO_FEW
= 'fileCountTooFew'- Inherited_from
- \Zend_Validate_File_Count::TOO_FEW
Properties

\Zend_Translate $_defaultTranslator = Default translation object for all validate objects
Inherited from: \Zend_Validate_Abstract::$$_defaultTranslator\Zend_Validate_File_Count::$$_defaultTranslator- Type
- \Zend_Translate
- Inherited_from
- \Zend_Validate_Abstract::$$_defaultTranslator
- Inherited_from
- \Zend_Validate_File_Count::$$_defaultTranslator

array $_errors = array()Array of validation failure message codes
Inherited from: \Zend_Validate_Abstract::$$_errors\Zend_Validate_File_Count::$$_errorsarray()Details- Type
- array
- Inherited_from
- \Zend_Validate_Abstract::$$_errors
- Inherited_from
- \Zend_Validate_File_Count::$$_errors

integer|null $_max =
If null, there is no maximum file count
- Type
- integer | null
- Inherited_from
- \Zend_Validate_File_Count::$$_max

Integer $_messageLength = -1Limits the maximum returned length of a error message
Inherited from: \Zend_Validate_Abstract::$$_messageLength\Zend_Validate_File_Count::$$_messageLength-1Details- Type
- Integer
- Inherited_from
- \Zend_Validate_Abstract::$$_messageLength
- Inherited_from
- \Zend_Validate_File_Count::$$_messageLength

array $_messageTemplates = array(self::TOO_MUCH => "Too much words, maximum '%max%' are allowed but '%count%' were counted", self::TOO_LESS => "Too less words, minimum '%min%' are expected but '%count%' were counted", self::NOT_FOUND => "File '%value%' is not readable or does not exist")Validation failure message template definitions
array(self::TOO_MUCH => "Too much words, maximum '%max%' are allowed but '%count%' were counted", self::TOO_LESS => "Too less words, minimum '%min%' are expected but '%count%' were counted", self::NOT_FOUND => "File '%value%' is not readable or does not exist")Details- Type
- array

array $_messageVariables = array('min' => '_min', 'max' => '_max', 'count' => '_count')Additional variables available for validation failure messages
Inherited from: \Zend_Validate_File_Count::$$_messageVariablesarray('min' => '_min', 'max' => '_max', 'count' => '_count')Details- Type
- array
- Inherited_from
- \Zend_Validate_File_Count::$$_messageVariables

array $_messages = array()Array of validation failure messages
Inherited from: \Zend_Validate_Abstract::$$_messages\Zend_Validate_File_Count::$$_messagesarray()Details- Type
- array
- Inherited_from
- \Zend_Validate_Abstract::$$_messages
- Inherited_from
- \Zend_Validate_File_Count::$$_messages

integer $_min =
If null, there is no minimum file count
- Type
- integer
- Inherited_from
- \Zend_Validate_File_Count::$$_min

bool $_obscureValue = falseFlag indidcating whether or not value should be obfuscated in error messages
Inherited from: \Zend_Validate_Abstract::$$_obscureValue\Zend_Validate_File_Count::$$_obscureValuefalseDetails- Type
- bool
- Inherited_from
- \Zend_Validate_Abstract::$$_obscureValue
- Inherited_from
- \Zend_Validate_File_Count::$$_obscureValue

\Zend_Translate $_translator = Translation object
Inherited from: \Zend_Validate_Abstract::$$_translator\Zend_Validate_File_Count::$$_translator- Type
- \Zend_Translate
- Inherited_from
- \Zend_Validate_Abstract::$$_translator
- Inherited_from
- \Zend_Validate_File_Count::$$_translator

Boolean $_translatorDisabled = falseIs translation disabled?
Inherited from: \Zend_Validate_Abstract::$$_translatorDisabled\Zend_Validate_File_Count::$$_translatorDisabledfalseDetails- Type
- Boolean
- Inherited_from
- \Zend_Validate_Abstract::$$_translatorDisabled
- Inherited_from
- \Zend_Validate_File_Count::$$_translatorDisabled

mixed $_value = The value to be validated
Inherited from: \Zend_Validate_Abstract::$$_value\Zend_Validate_File_Count::$$_value- Type
- mixed
- Inherited_from
- \Zend_Validate_Abstract::$$_value
- Inherited_from
- \Zend_Validate_File_Count::$$_value
Methods

__construct(integer | array | \Zend_Config $options) : void
Min limits the file count, when used with max=null it is the maximum file count It also accepts an array with the keys 'min' and 'max'
If $options is a integer, it will be used as maximum file count As Array is accepts the following keys: 'min': Minimum filecount 'max': Maximum filecount
| Name | Type | Description |
|---|---|---|
| $options | integer | array | \Zend_Config | Options for the adapter |

__get(string $property) : mixedMagic function returns the value of the requested property, if and only if it is the value or a message variable.
Inherited from: \Zend_Validate_Abstract::__get()\Zend_Validate_File_Count::__get()| Name | Type | Description |
|---|---|---|
| $property | string |
| Type | Description |
|---|---|
| mixed |
| Exception | Description |
|---|---|
| \Zend_Validate_Exception |

_createMessage(string $messageKey, string $value) : stringConstructs and returns a validation failure message with the given message key and value.
Inherited from: \Zend_Validate_Abstract::_createMessage()\Zend_Validate_File_Count::_createMessage()Returns null if and only if $messageKey does not correspond to an existing template.
If a translator is available and a translation exists for $messageKey, the translation will be used.
| Name | Type | Description |
|---|---|---|
| $messageKey | string | |
| $value | string |
| Type | Description |
|---|---|
| string |

_error(string $messageKey, string $value = null) : void
| Name | Type | Description |
|---|---|---|
| $messageKey | string | |
| $value | string | OPTIONAL |

_setValue(mixed $value) : voidSets the value to be validated and clears the messages and errors arrays
Inherited from: \Zend_Validate_Abstract::_setValue()\Zend_Validate_File_Count::_setValue()| Name | Type | Description |
|---|---|---|
| $value | mixed |

_throw(string $file, string $errorType) : falseThrows an error of the given type
| Name | Type | Description |
|---|---|---|
| $file | string | |
| $errorType | string |
| Type | Description |
|---|---|
| false |

getDefaultTranslator() : \Zend_Translate_Adapter | nullGet default translation object for all validate objects
Inherited from: \Zend_Validate_Abstract::getDefaultTranslator()\Zend_Validate_File_Count::getDefaultTranslator()| Type | Description |
|---|---|
| \Zend_Translate_Adapter | null |

getErrors() : arrayReturns array of validation failure message codes
Inherited from: \Zend_Validate_Abstract::getErrors()\Zend_Validate_File_Count::getErrors()| Type | Description |
|---|---|
| array |

getMessageLength() : integerReturns the maximum allowed message length
Inherited from: \Zend_Validate_Abstract::getMessageLength()\Zend_Validate_File_Count::getMessageLength()| Type | Description |
|---|---|
| integer |

getMessageTemplates() : arrayReturns the message templates from the validator
Inherited from: \Zend_Validate_Abstract::getMessageTemplates()\Zend_Validate_File_Count::getMessageTemplates()| Type | Description |
|---|---|
| array |

getMessageVariables() : arrayReturns an array of the names of variables that are used in constructing validation failure messages
Inherited from: \Zend_Validate_Abstract::getMessageVariables()\Zend_Validate_File_Count::getMessageVariables()| Type | Description |
|---|---|
| array |

getMessages() : arrayReturns array of validation failure messages
Inherited from: \Zend_Validate_Abstract::getMessages()\Zend_Validate_File_Count::getMessages()The array keys are validation failure message identifiers, and the array values are the corresponding human-readable message strings.
If isValid() was never called or if the most recent isValid() call returned true, then this method returns an empty array.
| Type | Description |
|---|---|
| array |

getObscureValue() : boolRetrieve flag indicating whether or not value should be obfuscated in messages
Inherited from: \Zend_Validate_Abstract::getObscureValue()\Zend_Validate_File_Count::getObscureValue()| Type | Description |
|---|---|
| bool |

getTranslator() : \Zend_Translate_Adapter | nullReturn translation object
Inherited from: \Zend_Validate_Abstract::getTranslator()\Zend_Validate_File_Count::getTranslator()| Type | Description |
|---|---|
| \Zend_Translate_Adapter | null |

hasDefaultTranslator() : booleanIs there a default translation object set?
Inherited from: \Zend_Validate_Abstract::hasDefaultTranslator()\Zend_Validate_File_Count::hasDefaultTranslator()| Type | Description |
|---|---|
| boolean |

hasTranslator() : boolDoes this validator have its own specific translator?
Inherited from: \Zend_Validate_Abstract::hasTranslator()\Zend_Validate_File_Count::hasTranslator()| Type | Description |
|---|---|
| bool |

isValid(string $value, array $file = null) : booleanDefined by Zend_Validate_Interface
Returns true if and only if the counted words are at least min and not bigger than max (when max is not null).
| Name | Type | Description |
|---|---|---|
| $value | string | Filename to check for word count |
| $file | array | File data from Zend_File_Transfer |
| Type | Description |
|---|---|
| boolean |
| Exception | Description |
|---|---|
| \Zend_Validate_Exception | If validation of $value is impossible |

setDefaultTranslator(\Zend_Translate | \Zend_Translate_Adapter | null $translator = null) : voidSet default translation object for all validate objects
Inherited from: \Zend_Validate_Abstract::setDefaultTranslator()\Zend_Validate_File_Count::setDefaultTranslator()| Name | Type | Description |
|---|---|---|
| $translator | \Zend_Translate | \Zend_Translate_Adapter | null |

setDisableTranslator(bool $flag) : \Zend_Validate_AbstractIndicate whether or not translation should be disabled
Inherited from: \Zend_Validate_Abstract::setDisableTranslator()\Zend_Validate_File_Count::setDisableTranslator()| Name | Type | Description |
|---|---|---|
| $flag | bool |
| Type | Description |
|---|---|
| \Zend_Validate_Abstract |

setMax(integer | array $max) : \Zend_Validate_StringLength
| Name | Type | Description |
|---|---|---|
| $max | integer | array | The maximum file count |
| Type | Description |
|---|---|
| \Zend_Validate_StringLength | Provides a fluent interface |
| Exception | Description |
|---|---|
| \Zend_Validate_Exception | When max is smaller than min |

setMessage(string $messageString, string $messageKey = null) : \Zend_Validate_AbstractSets the validation failure message template for a particular key
Inherited from: \Zend_Validate_Abstract::setMessage()\Zend_Validate_File_Count::setMessage()| Name | Type | Description |
|---|---|---|
| $messageString | string | |
| $messageKey | string | OPTIONAL |
| Type | Description |
|---|---|
| \Zend_Validate_Abstract | Provides a fluent interface |
| Exception | Description |
|---|---|
| \Zend_Validate_Exception |

setMessageLength(integer $length = -1) : voidSets the maximum allowed message length
Inherited from: \Zend_Validate_Abstract::setMessageLength()\Zend_Validate_File_Count::setMessageLength()| Name | Type | Description |
|---|---|---|
| $length | integer |

setMessages(array $messages) : \Zend_Validate_AbstractSets validation failure message templates given as an array, where the array keys are the message keys, and the array values are the message template strings.
Inherited from: \Zend_Validate_Abstract::setMessages()\Zend_Validate_File_Count::setMessages()| Name | Type | Description |
|---|---|---|
| $messages | array |
| Type | Description |
|---|---|
| \Zend_Validate_Abstract |

setMin(integer | array $min) : \Zend_Validate_File_Count
| Name | Type | Description |
|---|---|---|
| $min | integer | array | The minimum file count |
| Type | Description |
|---|---|
| \Zend_Validate_File_Count | Provides a fluent interface |
| Exception | Description |
|---|---|
| \Zend_Validate_Exception | When min is greater than max |

setObscureValue(bool $flag) : \Zend_Validate_AbstractSet flag indicating whether or not value should be obfuscated in messages
Inherited from: \Zend_Validate_Abstract::setObscureValue()\Zend_Validate_File_Count::setObscureValue()| Name | Type | Description |
|---|---|---|
| $flag | bool |
| Type | Description |
|---|---|
| \Zend_Validate_Abstract |

setTranslator(\Zend_Translate | \Zend_Translate_Adapter | null $translator = null) : \Zend_Validate_AbstractSet translation object
Inherited from: \Zend_Validate_Abstract::setTranslator()\Zend_Validate_File_Count::setTranslator()| Name | Type | Description |
|---|---|---|
| $translator | \Zend_Translate | \Zend_Translate_Adapter | null |
| Type | Description |
|---|---|
| \Zend_Validate_Abstract |

translatorIsDisabled() : boolIs translation disabled?
Inherited from: \Zend_Validate_Abstract::translatorIsDisabled()\Zend_Validate_File_Count::translatorIsDisabled()| Type | Description |
|---|---|
| bool |