Validate/Db/RecordExists.php

Show:

inherited

Classes
- \Zend_Validate_Db_RecordExists

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 license@zend.com 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: RecordExists.php 24593 2012-01-05 20:35:02Z matthew $

\Zend_Validate_Db_RecordExists
jump to top

Package: Zend\Validate

Confirms a record exists in a table.

Parent(s): \Zend_Validate_Db_Abstract < \Zend_Validate_Abstract
Category: Zend
Copyright: Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
License: New BSD License
Uses: \global\Zend_Validate_Db_Abstract

Constants

 
                ERROR_NO_RECORD_FOUND
                = 'noRecordFound'

inherited

Error constants

Inherited from: \Zend_Validate_Db_Abstract::ERROR_NO_RECORD_FOUND

Inherited_from: \Zend_Validate_Db_Abstract::ERROR_NO_RECORD_FOUND

 
                ERROR_RECORD_FOUND
                = 'recordFound'

inheritedInherited from: \Zend_Validate_Db_Abstract::ERROR_RECORD_FOUND

Inherited_from: \Zend_Validate_Db_Abstract::ERROR_RECORD_FOUND

Properties

\unknown_type $_adapter = null

inherited

Database adapter to use.

Inherited from: \Zend_Validate_Db_Abstract::$$_adapter

If null isValid() will use Zend_Db::getInstance instead

Default valuenullDetails

Type: \unknown_type
Inherited_from: \Zend_Validate_Db_Abstract::$$_adapter

\Zend_Translate $_defaultTranslator

staticinherited

Default translation object for all validate objects

Inherited from: \Zend_Validate_Abstract::$$_defaultTranslator \Zend_Validate_Db_Abstract::$$_defaultTranslator

Details

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

array $_errors = array()

inherited

Array of validation failure message codes

Inherited from: \Zend_Validate_Abstract::$$_errors \Zend_Validate_Db_Abstract::$$_errors

Default valuearray()Details

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

mixed $_exclude = null

inherited

Inherited from: \Zend_Validate_Db_Abstract::$$_exclude

Default valuenullDetails

Type: mixed
Inherited_from: \Zend_Validate_Db_Abstract::$$_exclude

string $_field = ''

inherited

Inherited from: \Zend_Validate_Db_Abstract::$$_field

Default value''Details

Type: string
Inherited_from: \Zend_Validate_Db_Abstract::$$_field

Integer $_messageLength = -1

staticinherited

Limits the maximum returned length of a error message

Inherited from: \Zend_Validate_Abstract::$$_messageLength \Zend_Validate_Db_Abstract::$$_messageLength

Default value-1Details

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

array $_messageTemplates = array(self::ERROR_NO_RECORD_FOUND => "No record matching '%value%' was found", self::ERROR_RECORD_FOUND => "A record matching '%value%' was found")

inherited

Validation failure message template definitions

Inherited from: \Zend_Validate_Db_Abstract::$$_messageTemplates

Default value

array(self::ERROR_NO_RECORD_FOUND => "No record matching '%value%' was found", self::ERROR_RECORD_FOUND => "A record matching '%value%' was found")

Details

Type: array
Inherited_from: \Zend_Validate_Db_Abstract::$$_messageTemplates

array $_messageVariables = array()

inherited

Additional variables available for validation failure messages

Inherited from: \Zend_Validate_Abstract::$$_messageVariables \Zend_Validate_Db_Abstract::$$_messageVariables

Default valuearray()Details

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

array $_messages = array()

inherited

Array of validation failure messages

Inherited from: \Zend_Validate_Abstract::$$_messages \Zend_Validate_Db_Abstract::$$_messages

Default valuearray()Details

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

bool $_obscureValue = false

inherited

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

Inherited from: \Zend_Validate_Abstract::$$_obscureValue \Zend_Validate_Db_Abstract::$$_obscureValue

Default valuefalseDetails

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

string $_schema = null

inherited

Inherited from: \Zend_Validate_Db_Abstract::$$_schema

Default valuenullDetails

Type: string
Inherited_from: \Zend_Validate_Db_Abstract::$$_schema

\Zend_Db_Select $_select

inherited

Select object to use.

Inherited from: \Zend_Validate_Db_Abstract::$$_select

can be set, or will be auto-generated

Details

Type: \Zend_Db_Select
Inherited_from: \Zend_Validate_Db_Abstract::$$_select

string $_table = ''

inherited

Inherited from: \Zend_Validate_Db_Abstract::$$_table

Default value''Details

Type: string
Inherited_from: \Zend_Validate_Db_Abstract::$$_table

\Zend_Translate $_translator

inherited

Translation object

Inherited from: \Zend_Validate_Abstract::$$_translator \Zend_Validate_Db_Abstract::$$_translator

Details

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

Boolean $_translatorDisabled = false

inherited

Is translation disabled?

Inherited from: \Zend_Validate_Abstract::$$_translatorDisabled \Zend_Validate_Db_Abstract::$$_translatorDisabled

Default valuefalseDetails

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

mixed $_value

inherited

The value to be validated

Inherited from: \Zend_Validate_Abstract::$$_value \Zend_Validate_Db_Abstract::$$_value

Details

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

Methods

__construct(array | \Zend_Config $options) : void

inherited

Provides basic configuration for use with Zend_Validate_Db Validators Setting $exclude allows a single record to be excluded from matching.

Inherited from: \Zend_Validate_Db_Abstract::__construct()

Exclude can either be a String containing a where clause, or an array with field and value keys to define the where clause added to the sql. A database adapter may optionally be supplied to avoid using the registered default adapter.

The following option keys are supported: 'table' => The database table to validate against 'schema' => The schema keys 'field' => The field to check for a match 'exclude' => An optional where clause or field/value pair to exclude from the query 'adapter' => An optional database adapter to use

Parameters

Name	Type	Description
$options	array \| \Zend_Config	Options to use for this validator

__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_Validate_Db_Abstract::__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_Validate_Db_Abstract::_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_Validate_Db_Abstract::_error()

Parameters

Name	Type	Description
$messageKey	string
$value	string	OPTIONAL

_query(String $value) : Array

inherited

Run query and returns matches, or null if no matches are found.

Inherited from: \Zend_Validate_Db_Abstract::_query()

Parameters

Name	Type	Description
$value	String

Returns

Type	Description
Array	when matches are found.

_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_Validate_Db_Abstract::_setValue()

Parameters

Name	Type	Description
$value	mixed

getAdapter() : \Zend_Db_Adapter

inherited

Returns the set adapter

Inherited from: \Zend_Validate_Db_Abstract::getAdapter()

Returns

Type	Description
\Zend_Db_Adapter

getDefaultTranslator() : \Zend_Translate_Adapter | null

staticinherited

Get default translation object for all validate objects

Inherited from: \Zend_Validate_Abstract::getDefaultTranslator()\Zend_Validate_Db_Abstract::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_Validate_Db_Abstract::getErrors()

Returns

Type	Description
array

getExclude() : string | array

inherited

Returns the set exclude clause

Inherited from: \Zend_Validate_Db_Abstract::getExclude()

Returns

Type	Description
string \| array

getField() : string | array

inherited

Returns the set field

Inherited from: \Zend_Validate_Db_Abstract::getField()

Returns

Type	Description
string \| array

getMessageLength() : integer

staticinherited

Returns the maximum allowed message length

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

Returns

Type	Description
integer

getMessageTemplates() : array

inherited

Returns the message templates from the validator

Inherited from: \Zend_Validate_Abstract::getMessageTemplates()\Zend_Validate_Db_Abstract::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_Validate_Db_Abstract::getMessageVariables()

Returns

Type	Description
array

getMessages() : array

inherited

Returns array of validation failure messages

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

getObscureValue() : bool

inherited

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

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

Returns

Type	Description
bool

getSchema() : string

inherited

Returns the set schema

Inherited from: \Zend_Validate_Db_Abstract::getSchema()

Returns

Type	Description
string

getSelect() : \Zend_Db_Select

inherited

Gets the select object to be used by the validator.

Inherited from: \Zend_Validate_Db_Abstract::getSelect()

If no select object was supplied to the constructor, then it will auto-generate one from the given table, schema, field, and adapter options.

Returns

Type	Description
\Zend_Db_Select	The Select object which will be used

getTable() : string

inherited

Returns the set table

Inherited from: \Zend_Validate_Db_Abstract::getTable()

Returns

Type	Description
string

getTranslator() : \Zend_Translate_Adapter | null

inherited

Return translation object

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

Returns

Type	Description
\Zend_Translate_Adapter \| null

hasDefaultTranslator() : boolean

staticinherited

Is there a default translation object set?

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

Returns

Type	Description
boolean

hasTranslator() : bool

inherited

Does this validator have its own specific translator?

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

Returns

Type	Description
bool

isValid(mixed $value) : boolean

Returns true if and only if $value meets the validation requirements

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

Returns

Type	Description
boolean

Throws

Exception	Description
\Zend_Validate_Exception	If validation of $value is impossible

setAdapter(\Zend_Db_Adapter_Abstract $adapter) : \Zend_Validate_Db_Abstract

inherited

Sets a new database adapter

Inherited from: \Zend_Validate_Db_Abstract::setAdapter()

Parameters

Name	Type	Description
$adapter	\Zend_Db_Adapter_Abstract

Returns

Type	Description
\Zend_Validate_Db_Abstract

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_Validate_Db_Abstract::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_Validate_Db_Abstract::setDisableTranslator()

Parameters

Name	Type	Description
$flag	bool

Returns

Type	Description
\Zend_Validate_Abstract

setExclude(string | array $exclude) : \Zend_Validate_Db_Abstract

inherited

Sets a new exclude clause

Inherited from: \Zend_Validate_Db_Abstract::setExclude()

Parameters

Name	Type	Description
$exclude	string \| array

Returns

Type	Description
\Zend_Validate_Db_Abstract

setField(string $field) : \Zend_Validate_Db_Abstract

inherited

Sets a new field

Inherited from: \Zend_Validate_Db_Abstract::setField()

Parameters

Name	Type	Description
$field	string

Returns

Type	Description
\Zend_Validate_Db_Abstract

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

Parameters

Name	Type	Description
$messages	array

Returns

Type	Description
\Zend_Validate_Abstract

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_Validate_Db_Abstract::setObscureValue()

Parameters

Name	Type	Description
$flag	bool

Returns

Type	Description
\Zend_Validate_Abstract

setSchema(string $schema) : \Zend_Validate_Db_Abstract

inherited

Sets a new schema

Inherited from: \Zend_Validate_Db_Abstract::setSchema()

Parameters

Name	Type	Description
$schema	string

Returns

Type	Description
\Zend_Validate_Db_Abstract

setSelect(\Zend_Db_Select $select) : \Zend_Validate_Db_Abstract

inherited

Sets the select object to be used by the validator

Inherited from: \Zend_Validate_Db_Abstract::setSelect()

Parameters

Name	Type	Description
$select	\Zend_Db_Select

Returns

Type	Description
\Zend_Validate_Db_Abstract

setTable(string $table) : \Zend_Validate_Db_Abstract

inherited

Sets a new table

Inherited from: \Zend_Validate_Db_Abstract::setTable()

Parameters

Name	Type	Description
$table	string

Returns

Type	Description
\Zend_Validate_Db_Abstract

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

inherited

Set translation object

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

Parameters

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

Returns

Type	Description
\Zend_Validate_Abstract

translatorIsDisabled() : bool

inherited

Is translation disabled?

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

Returns

Type	Description
bool

Validate/Db/RecordExists.php

\Zend_Validate_Db_RecordExistsjump to top

Constants

Properties

Methods

\Zend_Validate_Db_RecordExists
jump to top