Captcha/Word.php

Show:

inherited

Classes
- \Zend_Captcha_Word

Table of Contents

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_Captcha
Subpackage: Adapter

\Zend_Captcha_Word
jump to top

Package: Zend\Captcha\Adapter

Word-based captcha adapter

Generates random word which user should recognise

Parent(s): \Zend_Captcha_Base < \Zend_Validate_Abstract
Children: \Zend_Captcha_Figlet; \Zend_Captcha_Image; \Zend_Captcha_Dumb
Category: Zend
Copyright: Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
License: New BSD License
Version: $Id: Word.php 24593 2012-01-05 20:35:02Z matthew $

Constants

 
                MISSING_VALUE
                = 'missingValue'

 
                MISSING_ID
                = 'missingID'

 
                BAD_CAPTCHA
                = 'badCaptcha'

Properties

$C = array("b", "c", "d", "f", "g", "h", "j", "k", "m", "n", "p", "q", "r", "s", "t", "u", "v", "w", "x", "z")

static

Default valuearray("b", "c", "d", "f", "g", "h", "j", "k", "m", "n", "p", "q", "r", "s", "t", "u", "v", "w", "x", "z")Details

Type: n/a

$CN = array("b", "c", "d", "f", "g", "h", "j", "k", "m", "n", "p", "q", "r", "s", "t", "u", "v", "w", "x", "z", "2", "3", "4", "5", "6", "7", "8", "9")

static

Default value

array("b", "c", "d", "f", "g", "h", "j", "k", "m", "n", "p", "q", "r", "s", "t", "u", "v", "w", "x", "z", "2", "3", "4", "5", "6", "7", "8", "9")

Details

Type: n/a

$V = array("a", "e", "i", "o", "u", "y")

static

Default valuearray("a", "e", "i", "o", "u", "y")Details

Type: n/a

$VN = array("a", "e", "i", "o", "u", "y", "2", "3", "4", "5", "6", "7", "8", "9")

static

Default valuearray("a", "e", "i", "o", "u", "y", "2", "3", "4", "5", "6", "7", "8", "9")Details

Type: n/a

\Zend_Translate $_defaultTranslator =

staticinherited

Default translation object for all validate objects

Inherited from: \Zend_Validate_Abstract::$$_defaultTranslator \Zend_Captcha_Base::$$_defaultTranslator

Details

Type: \Zend_Translate
Inherited_from: \Zend_Validate_Abstract::$$_defaultTranslator
Inherited_from: \Zend_Captcha_Base::$$_defaultTranslator

array $_errors = array()

inherited

Array of validation failure message codes

Inherited from: \Zend_Validate_Abstract::$$_errors \Zend_Captcha_Base::$$_errors

Default valuearray()Details

Type: array
Inherited_from: \Zend_Validate_Abstract::$$_errors
Inherited_from: \Zend_Captcha_Base::$$_errors

string $_id =

Random session ID

Details

Type: string

boolean $_keepSession = false

Should generate() keep session or create a new one?

Default valuefalseDetails

Type: boolean

Integer $_messageLength = -1

staticinherited

Limits the maximum returned length of a error message

Inherited from: \Zend_Validate_Abstract::$$_messageLength \Zend_Captcha_Base::$$_messageLength

Default value-1Details

Type: Integer
Inherited_from: \Zend_Validate_Abstract::$$_messageLength
Inherited_from: \Zend_Captcha_Base::$$_messageLength

array $_messageTemplates = array(self::MISSING_VALUE => 'Empty captcha value', self::MISSING_ID => 'Captcha ID field is missing', self::BAD_CAPTCHA => 'Captcha value is wrong')

Error messages

Default value

array(self::MISSING_VALUE => 'Empty captcha value', self::MISSING_ID => 'Captcha ID field is missing', self::BAD_CAPTCHA => 'Captcha value is wrong')

Details

Type: array

array $_messageVariables = array()

inherited

Additional variables available for validation failure messages

Inherited from: \Zend_Validate_Abstract::$$_messageVariables \Zend_Captcha_Base::$$_messageVariables

Default valuearray()Details

Type: array
Inherited_from: \Zend_Validate_Abstract::$$_messageVariables
Inherited_from: \Zend_Captcha_Base::$$_messageVariables

array $_messages = array()

inherited

Array of validation failure messages

Inherited from: \Zend_Validate_Abstract::$$_messages \Zend_Captcha_Base::$$_messages

Default valuearray()Details

Type: array
Inherited_from: \Zend_Validate_Abstract::$$_messages
Inherited_from: \Zend_Captcha_Base::$$_messages

string $_name =

inherited

Element name

Inherited from: \Zend_Captcha_Base::$$_name

Useful to generate/check form fields

Details

Type: string
Inherited_from: \Zend_Captcha_Base::$$_name

bool $_obscureValue = false

inherited

Flag indidcating whether or not value should be obfuscated in error messages

Inherited from: \Zend_Validate_Abstract::$$_obscureValue \Zend_Captcha_Base::$$_obscureValue

Default valuefalseDetails

Type: bool
Inherited_from: \Zend_Validate_Abstract::$$_obscureValue
Inherited_from: \Zend_Captcha_Base::$$_obscureValue

array $_options = array()

inherited

Captcha options

Inherited from: \Zend_Captcha_Base::$$_options

Default valuearray()Details

Type: array
Inherited_from: \Zend_Captcha_Base::$$_options

\Zend_Session_Namespace $_session =

Session

Details

Type: \Zend_Session_Namespace

string $_sessionClass = 'Zend_Session_Namespace'

Class name for sessions

Default value'Zend_Session_Namespace'Details

Type: string

array $_skipOptions = array('options', 'config')

inherited

Options to skip when processing options

Inherited from: \Zend_Captcha_Base::$$_skipOptions

Default valuearray('options', 'config')Details

Type: array
Inherited_from: \Zend_Captcha_Base::$$_skipOptions

integer $_timeout = 300

Session lifetime for the captcha data

Default value300Details

Type: integer

\Zend_Translate $_translator =

inherited

Translation object

Inherited from: \Zend_Validate_Abstract::$$_translator \Zend_Captcha_Base::$$_translator

Details

Type: \Zend_Translate
Inherited_from: \Zend_Validate_Abstract::$$_translator
Inherited_from: \Zend_Captcha_Base::$$_translator

Boolean $_translatorDisabled = false

inherited

Is translation disabled?

Inherited from: \Zend_Validate_Abstract::$$_translatorDisabled \Zend_Captcha_Base::$$_translatorDisabled

Default valuefalseDetails

Type: Boolean
Inherited_from: \Zend_Validate_Abstract::$$_translatorDisabled
Inherited_from: \Zend_Captcha_Base::$$_translatorDisabled

boolean $_useNumbers = true

Should the numbers be used or only letters

Default valuetrueDetails

Type: boolean

mixed $_value =

inherited

The value to be validated

Inherited from: \Zend_Validate_Abstract::$$_value \Zend_Captcha_Base::$$_value

Details

Type: mixed
Inherited_from: \Zend_Validate_Abstract::$$_value
Inherited_from: \Zend_Captcha_Base::$$_value

string $_word =

Generated word

Details

Type: string

integer $_wordlen = 8

Length of the word to generate

Default value8Details

Type: integer

Methods

__construct(array | \Zend_Config $options = null) : void

inherited

Constructor

Inherited from: \Zend_Captcha_Base::__construct()

Parameters

Name	Type	Description
$options	array \| \Zend_Config

__get(string $property) : mixed

inherited

Magic 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_Captcha_Base::__get()

Parameters

Name	Type	Description
$property	string

Returns

Type	Description
mixed

Throws

Exception	Description
\Zend_Validate_Exception

_createMessage(string $messageKey, string $value) : string

inherited

Constructs and returns a validation failure message with the given message key and value.

Inherited from: \Zend_Validate_Abstract::_createMessage()\Zend_Captcha_Base::_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.

Parameters

Name	Type	Description
$messageKey	string
$value	string

Returns

Type	Description
string

_error(string $messageKey, string $value = null) : void

inherited

Inherited from: \Zend_Validate_Abstract::_error()\Zend_Captcha_Base::_error()

Parameters

Name	Type	Description
$messageKey	string
$value	string	OPTIONAL

_generateRandomId() : void

_generateWord() : string

Generate new random word

Returns

Type	Description
string

_setId(string $id) : void

Set captcha identifier

Parameters

Name	Type	Description
$id	string	return Zend_Captcha_Word

_setValue(mixed $value) : void

inherited

Sets the value to be validated and clears the messages and errors arrays

Inherited from: \Zend_Validate_Abstract::_setValue()\Zend_Captcha_Base::_setValue()

Parameters

Name	Type	Description
$value	mixed

_setWord(string $word) : \Zend_Captcha_Word

Set captcha word

Parameters

Name	Type	Description
$word	string

Returns

Type	Description
\Zend_Captcha_Word

generate() : string

Generate new session ID and new word

Returns

Type	Description
string	session ID

getDecorator() : string

Get captcha decorator

By default, return null, indicating no extra decorator needed.

Returns

Type	Description
string

getDefaultTranslator() : \Zend_Translate_Adapter | null

staticinherited

Get default translation object for all validate objects

Inherited from: \Zend_Validate_Abstract::getDefaultTranslator()\Zend_Captcha_Base::getDefaultTranslator()

Returns

Type	Description
\Zend_Translate_Adapter \| null

getErrors() : array

inherited

Returns array of validation failure message codes

Inherited from: \Zend_Validate_Abstract::getErrors()\Zend_Captcha_Base::getErrors()

Returns

Type	Description
array

getId() : string

Retrieve captcha ID

Returns

Type	Description
string

getMessageLength() : integer

staticinherited

Returns the maximum allowed message length

Inherited from: \Zend_Validate_Abstract::getMessageLength()\Zend_Captcha_Base::getMessageLength()

Returns

Type	Description
integer

getMessageTemplates() : array

inherited

Returns the message templates from the validator

Inherited from: \Zend_Validate_Abstract::getMessageTemplates()\Zend_Captcha_Base::getMessageTemplates()

Returns

Type	Description
array

getMessageVariables() : array

inherited

Returns an array of the names of variables that are used in constructing validation failure messages

Inherited from: \Zend_Validate_Abstract::getMessageVariables()\Zend_Captcha_Base::getMessageVariables()

Returns

Type	Description
array

getMessages() : array

inherited

Returns array of validation failure messages

Inherited from: \Zend_Validate_Abstract::getMessages()\Zend_Captcha_Base::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.

Returns

Type	Description
array

getName() : string

inherited

Get name

Inherited from: \Zend_Captcha_Base::getName()

Returns

Type	Description
string

getObscureValue() : bool

inherited

Retrieve flag indicating whether or not value should be obfuscated in messages

Inherited from: \Zend_Validate_Abstract::getObscureValue()\Zend_Captcha_Base::getObscureValue()

Returns

Type	Description
bool

getOptions() : array

inherited

Retrieve options representing object state

Inherited from: \Zend_Captcha_Base::getOptions()

Returns

Type	Description
array

getSession() : \Zend_Session_Namespace

Get session object

Returns

Type	Description
\Zend_Session_Namespace

getSessionClass() : string

Retrieve session class to utilize

Returns

Type	Description
string

getTimeout() : int

Get session token timeout

Returns

Type	Description
int

getTranslator() : \Zend_Translate_Adapter | null

inherited

Return translation object

Inherited from: \Zend_Validate_Abstract::getTranslator()\Zend_Captcha_Base::getTranslator()

Returns

Type	Description
\Zend_Translate_Adapter \| null

getUseNumbers() : bool

Numbers should be included in the pattern?

Returns

Type	Description
bool

getWord() : string

Get captcha word

Returns

Type	Description
string

getWordlen() : integer

Retrieve word length to use when genrating captcha

Returns

Type	Description
integer

hasDefaultTranslator() : boolean

staticinherited

Is there a default translation object set?

Inherited from: \Zend_Validate_Abstract::hasDefaultTranslator()\Zend_Captcha_Base::hasDefaultTranslator()

Returns

Type	Description
boolean

hasTranslator() : bool

inherited

Does this validator have its own specific translator?

Inherited from: \Zend_Validate_Abstract::hasTranslator()\Zend_Captcha_Base::hasTranslator()

Returns

Type	Description
bool

isValid(mixed $value, $context = null) : boolean

Validate the word

If $value fails validation, then this method returns false, and getMessages() will return an array of messages that explain why the validation failed.

Parameters

Name	Type	Description
$value	mixed
$context

Returns

Type	Description
boolean

Throws

Exception	Description
\Zend_Validate_Exception	If validation of $value is impossible

Details

See: \global\Zend_Validate_Interface::isValid()

render(\Zend_View_Interface $view = null, mixed $element = null) : string

inherited

Display the captcha

Inherited from: \Zend_Captcha_Adapter::render()\Zend_Captcha_Base::render()

Parameters

Name	Type	Description
$view	\Zend_View_Interface
$element	mixed

Returns

Type	Description
string

setConfig(\Zend_Config $config) : \Zend_Captcha_Base

inherited

Set object state from config object

Inherited from: \Zend_Captcha_Base::setConfig()

Parameters

Name	Type	Description
$config	\Zend_Config

Returns

Type	Description
\Zend_Captcha_Base

setDefaultTranslator(\Zend_Translate | \Zend_Translate_Adapter | null $translator = null) : void

staticinherited

Set default translation object for all validate objects

Inherited from: \Zend_Validate_Abstract::setDefaultTranslator()\Zend_Captcha_Base::setDefaultTranslator()

Parameters

Name	Type	Description
$translator	\Zend_Translate \| \Zend_Translate_Adapter \| null

setDisableTranslator(bool $flag) : \Zend_Validate_Abstract

inherited

Indicate whether or not translation should be disabled

Inherited from: \Zend_Validate_Abstract::setDisableTranslator()\Zend_Captcha_Base::setDisableTranslator()

Parameters

Name	Type	Description
$flag	bool

Returns

Type	Description
\Zend_Validate_Abstract

setKeepSession(bool $keepSession) : \Zend_Captcha_Word

Sets if session should be preserved on generate()

Parameters

Name	Type	Description
$keepSession	bool	Should session be kept on generate()?

Returns

Type	Description
\Zend_Captcha_Word

setMessage(string $messageString, string $messageKey = null) : \Zend_Validate_Abstract

inherited

Sets the validation failure message template for a particular key

Inherited from: \Zend_Validate_Abstract::setMessage()\Zend_Captcha_Base::setMessage()

Parameters

Name	Type	Description
$messageString	string
$messageKey	string	OPTIONAL

Returns

Type	Description
\Zend_Validate_Abstract	Provides a fluent interface

Throws

Exception	Description
\Zend_Validate_Exception

setMessageLength(integer $length = -1) : void

staticinherited

Sets the maximum allowed message length

Inherited from: \Zend_Validate_Abstract::setMessageLength()\Zend_Captcha_Base::setMessageLength()

Parameters

Name	Type	Description
$length	integer

setMessages(array $messages) : \Zend_Validate_Abstract

inherited

Sets 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_Captcha_Base::setMessages()

Parameters

Name	Type	Description
$messages	array

Returns

Type	Description
\Zend_Validate_Abstract

setName(string $name) : \Zend_Captcha_Adapter

inherited

Set name

Inherited from: \Zend_Captcha_Base::setName()

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
\Zend_Captcha_Adapter

setObscureValue(bool $flag) : \Zend_Validate_Abstract

inherited

Set flag indicating whether or not value should be obfuscated in messages

Inherited from: \Zend_Validate_Abstract::setObscureValue()\Zend_Captcha_Base::setObscureValue()

Parameters

Name	Type	Description
$flag	bool

Returns

Type	Description
\Zend_Validate_Abstract

setOption(string $key, string $value) : \Zend_Form_Element

inherited

Set single option for the object

Inherited from: \Zend_Captcha_Base::setOption()

Parameters

Name	Type	Description
$key	string
$value	string

Returns

Type	Description
\Zend_Form_Element

setOptions(array $options = null) : \Zend_Form_Element

inherited

Set object state from options array

Inherited from: \Zend_Captcha_Base::setOptions()

Parameters

Name	Type	Description
$options	array

Returns

Type	Description
\Zend_Form_Element

setSession(\Zend_Session_Namespace $session) : \Zend_Captcha_Word

Set session namespace object

Parameters

Name	Type	Description
$session	\Zend_Session_Namespace

Returns

Type	Description
\Zend_Captcha_Word

setSessionClass(string $_sessionClass) : \Zend_Captcha_Word

Set session class for persistence

Parameters

Name	Type	Description
$_sessionClass	string

Returns

Type	Description
\Zend_Captcha_Word

setTimeout(int $ttl) : \Zend_Captcha_Word

Set timeout for session token

Parameters

Name	Type	Description
$ttl	int

Returns

Type	Description
\Zend_Captcha_Word

setTranslator(\Zend_Translate | \Zend_Translate_Adapter | null $translator = null) : \Zend_Validate_Abstract

inherited

Set translation object

Inherited from: \Zend_Validate_Abstract::setTranslator()\Zend_Captcha_Base::setTranslator()

Parameters

Name	Type	Description
$translator	\Zend_Translate \| \Zend_Translate_Adapter \| null

Returns

Type	Description
\Zend_Validate_Abstract

setUseNumbers(bool $_useNumbers) : \Zend_Captcha_Word

Set if numbers should be included in the pattern

Parameters

Name	Type	Description
$_useNumbers	bool	numbers should be included in the pattern?

Returns

Type	Description
\Zend_Captcha_Word

setWordlen(integer $wordlen) : \Zend_Captcha_Word

Set word length of captcha

Parameters

Name	Type	Description
$wordlen	integer

Returns

Type	Description
\Zend_Captcha_Word

translatorIsDisabled() : bool

inherited

Is translation disabled?

Inherited from: \Zend_Validate_Abstract::translatorIsDisabled()\Zend_Captcha_Base::translatorIsDisabled()

Returns

Type	Description
bool

Captcha/Word.php

\Zend_Captcha_Wordjump to top

Constants

Properties

Methods

\Zend_Captcha_Word
jump to top