Docs For Class Zend_Validate

Description

Implements interfaces:

Zend_Validate_Interface

Please note there are two standalone test scripts for testing IDN characters due to problems with file encoding.

The first is tests/Zend/Validate/HostnameTestStandalone.php which is designed to be run on the command line.

The second is tests/Zend/Validate/HostnameTestForm.php which is designed to be run via HTML to allow users to test entering UTF-8 characters in a form.

copyright: Copyright (c) 2005-2007 Zend Technologies USA Inc. (http://www.zend.com)
license: New BSD License

Located in /Validate/Hostname.php (line 50)

Class Constant Summary

ALLOW_ALL = 7

ALLOW_DNS = 1

ALLOW_IP = 2

ALLOW_LOCAL = 4

Variable Summary

integer $_allow

unknown_type $_check

array $_messages

array $_validTlds

Method Summary

void __construct ([integer $allow = self::ALLOW_DNS], [boolean $validateIdn = true], [boolean $validateTld = true], integer $check)

integer getAllow ()

array getMessages ()

boolean isValid (string $value)

Zend_Validate_Hostname setAllow (integer $allow)

Zend_Validate_Hostname setCheck (integer $check)

void setValidateIdn (boolean $allowed)

void setValidateTld (boolean $allowed)

Zend_Validate_Hostname _checkRegexType (string $type)

Variables

integer $_allow (line 91)

Bit field of ALLOW constants; determines which types of hostnames are allowed

access: protected

unknown_type $_check (line 98)

Bit field of CHECK constants; determines what additional hostname checks to make

access: protected

array $_messages = array() (line 105)

Array of validation failure messages

access: protected

array $_validTlds = array(
'ac', 'ad', 'ae', 'aero', 'af', 'ag', 'ai', 'al', 'am', 'an', 'ao',
'aq', 'ar', 'arpa', 'as', 'at', 'au', 'aw', 'ax', 'az', 'ba', 'bb',
'bd', 'be', 'bf', 'bg', 'bh', 'bi', 'biz', 'bj', 'bm', 'bn', 'bo',
'br', 'bs', 'bt', 'bv', 'bw', 'by', 'bz', 'ca', 'cat', 'cc', 'cd',
'cf', 'cg', 'ch', 'ci', 'ck', 'cl', 'cm', 'cn', 'co', 'com', 'coop',
'cr', 'cu', 'cv', 'cx', 'cy', 'cz', 'de', 'dj', 'dk', 'dm', 'do',
'dz', 'ec', 'edu', 'ee', 'eg', 'er', 'es', 'et', 'eu', 'fi', 'fj',
'fk', 'fm', 'fo', 'fr', 'ga', 'gb', 'gd', 'ge', 'gf', 'gg', 'gh',
'gi', 'gl', 'gm', 'gn', 'gov', 'gp', 'gq', 'gr', 'gs', 'gt', 'gu',
'gw', 'gy', 'hk', 'hm', 'hn', 'hr', 'ht', 'hu', 'id', 'ie', 'il',
'im', 'in', 'info', 'int', 'io', 'iq', 'ir', 'is', 'it', 'je', 'jm',
'jo', 'jobs', 'jp', 'ke', 'kg', 'kh', 'ki', 'km', 'kn', 'kr', 'kw',
'ky', 'kz', 'la', 'lb', 'lc', 'li', 'lk', 'lr', 'ls', 'lt', 'lu',
'lv', 'ly', 'ma', 'mc', 'md', 'mg', 'mh', 'mil', 'mk', 'ml', 'mm',
'mn', 'mo', 'mobi', 'mp', 'mq', 'mr', 'ms', 'mt', 'mu', 'museum', 'mv',
'mw', 'mx', 'my', 'mz', 'na', 'name', 'nc', 'ne', 'net', 'nf', 'ng',
'ni', 'nl', 'no', 'np', 'nr', 'nu', 'nz', 'om', 'org', 'pa', 'pe',
'pf', 'pg', 'ph', 'pk', 'pl', 'pm', 'pn', 'pr', 'pro', 'ps', 'pt',
'pw', 'py', 'qa', 're', 'ro', 'ru', 'rw', 'sa', 'sb', 'sc', 'sd',
'se', 'sg', 'sh', 'si', 'sj', 'sk', 'sl', 'sm', 'sn', 'so', 'sr',
'st', 'su', 'sv', 'sy', 'sz', 'tc', 'td', 'tf', 'tg', 'th', 'tj',
'tk', 'tl', 'tm', 'tn', 'to', 'tp', 'tr', 'travel', 'tt', 'tv', 'tw',
'tz', 'ua', 'ug', 'uk', 'um', 'us', 'uy', 'uz', 'va', 'vc', 've',
'vg', 'vi', 'vn', 'vu', 'wf', 'ws', 'ye', 'yt', 'yu', 'za', 'zm',
'zw'
) (line 113)

Array of valid top-level-domains

see: ftp://data.iana.org/TLD/tlds-alpha-by-domain.txt List of all TLDs by domain
access: protected

Methods

Constructor __construct (line 151)

Sets validator options

see: http://www.iana.org/cctld/specifications-policies-cctlds-01apr02.htm Technical Specifications for ccTLDs
access: public

void __construct ([integer $allow = self::ALLOW_DNS], [boolean $validateIdn = true], [boolean $validateTld = true], integer $check)

integer $allow: Set what types of hostname to allow (default ALLOW_DNS)
integer $check: Set what additional hostname checks to make (default CHECK_TLD)
boolean $validateIdn: Set whether IDN domains are validated (default true)
boolean $validateTld: Set whether the TLD element of a hostname is validated (default true)

getAllow (line 166)

Returns the allow option

access: public

integer getAllow ()

getMessages (line 392)

Defined by Zend_Validate_Interface

Returns array of validation failure messages

access: public

array getMessages ()

Implementation of:

Zend_Validate_Interface::getMessages(): Returns an array of messages that explain why a previous isValid() call returned false

isValid (line 228)

Defined by Zend_Validate_Interface

Returns true if and only if the $value is a valid hostname with respect to the current allow option

throws: Zend_Validate_Exception if a fatal error occurs for validation process
access: public

boolean isValid (string $value)

string $value

Implementation of:

Zend_Validate_Interface::isValid(): Returns true if and only if $value meets the validation requirements

setAllow (line 177)

Sets the allow option

return: Provides a fluent interface
access: public

Zend_Validate_Hostname setAllow (integer $allow)

integer $allow

setCheck (line 213)

Sets the check option

return: Provides a fluent interface
access: public

Zend_Validate_Hostname setCheck (integer $check)

integer $check

setValidateIdn (line 190)

Set whether IDN domains are validated

This only applies when DNS hostnames are validated

access: public

void setValidateIdn (boolean $allowed)

boolean $allowed: Set allowed to true to validate IDNs, and false to not validate them

setValidateTld (line 202)

Set whether the TLD element of a hostname is validated

This only applies when DNS hostnames are validated

access: public

void setValidateTld (boolean $allowed)

boolean $allowed: Set allowed to true to validate TLDs, and false to not validate them

_checkRegexType (line 404)

Throws an exception if a regex for $type does not exist

return: Provides a fluent interface
throws: Zend_Validate_Exception
access: protected

Zend_Validate_Hostname _checkRegexType (string $type)

string $type

Class Constants

ALLOW_ALL = 7 (line 70)

Allows all types of hostnames

ALLOW_DNS = 1 (line 55)

Allows Internet domain names (e.g., example.com)

ALLOW_IP = 2 (line 60)

Allows IP addresses

ALLOW_LOCAL = 4 (line 65)

Allows local network names (e.g., localhost, www.localdomain)