Introdução ao Zend Framework

 Conhecendo o Zend Framework


 Referência do Zend Framework

  • Zend_Gdata
  • Zend_Http
  • Zend_InfoCard
  • Zend_Json
  • Zend_Layout
  • Zend_Ldap
  • Zend_Loader
  • Zend_Locale
  • Zend_Log
  • Zend_Mail
  • Zend_Markup
  • Zend_Measure
  • Zend_Memory
  • Zend_Mime
  • Zend_Navigation
  • Zend_Oauth
  • Zend_OpenId
  • Zend_Paginator
  • Zend_Pdf
  • Zend_ProgressBar
  • Zend_Queue
  • Zend_Reflection
  • Zend_Registry
  • Zend_Rest

  • Zend_Search_Lucene
  • Zend_Serializer
  • Zend_Server
  • Zend_Service
  • Zend_Session
  • Zend_Soap
  • Zend_Tag
  • Zend_Test
  • Zend_Text
  • Zend_TimeSync
  • Zend_Tool
  • Zend_Tool_Framework
  • Zend_Tool_Project
  • Zend_Translate
  • Zend_Uri
  • Zend_Validate
  • Zend_Version
  • Zend_View
  • Zend_Wildfire
  • Zend_XmlRpc
  • ZendX_Console_Process_Unix
  • ZendX_JQuery
  • Translation 12.2% Update 2011-11-16 - Revision 24447 - Version ZF 1.11.x

    Capítulo 75. Zend_Validate


    75.1. Introduction
    75.1.1. What is a validator?
    75.1.2. Basic usage of validators
    75.1.3. Customizing messages
    75.1.4. Using the static is() method Namespaces
    75.1.5. Translating messages
    75.2. Standard Validation Classes
    75.2.1. Alnum Supported options for Zend_Validate_Alnum Basic usage Using whitespaces Using different languages
    75.2.2. Alpha Supported options for Zend_Validate_Alpha Basic usage Using whitespaces Using different languages
    75.2.3. Barcode Supported options for Zend_Validate_Barcode Basic usage Optional checksum Writing custom adapters
    75.2.4. Between Supported options for Zend_Validate_Between Default behaviour for Zend_Validate_Between Validation exclusive the border values
    75.2.5. Callback Supported options for Zend_Validate_Callback Basic usage Usage with closures Usage with class-based callbacks Adding options
    75.2.6. CreditCard Supported options for Zend_Validate_CreditCard Basic usage Accepting defined credit cards Validation by using foreign APIs
    75.2.7. Ccnum
    75.2.8. Date Supported options for Zend_Validate_Date Default date validation Localized date validation Self defined date validation
    75.2.9. Db_RecordExists and Db_NoRecordExists Supported options for Zend_Validate_Db_* Basic usage Excluding records Database Adapters Database Schemas
    75.2.10. Digits Supported options for Zend_Validate_Digits Validating digits
    75.2.11. EmailAddress Basic usage Options for validating Email Addresses Complex local parts Validating only the local part Validating different types of hostnames Checking if the hostname actually accepts email Validating International Domains Names Validating Top Level Domains Setting messages
    75.2.12. Float Supported options for Zend_Validate_Float Simple float validation Localized float validation
    75.2.13. GreaterThan Supported options for Zend_Validate_GreaterThan Basic usage
    75.2.14. Hex Supported options for Zend_Validate_Hex
    75.2.15. Hostname Supported options for Zend_Validate_Hostname Basic usage Validating different types of hostnames Validating International Domains Names Validating Top Level Domains
    75.2.16. Iban Supported options for Zend_Validate_Iban IBAN validation Application wide locale Ungreedy IBAN validation Region aware IBAN validation
    75.2.17. Identical Supported options for Zend_Validate_Identical Basic usage Identical objects Form elements Strict validation Configuration
    75.2.18. InArray Supported options for Zend_Validate_InArray Simple array validation Strict array validation Recursive array validation
    75.2.19. Int Supported options for Zend_Validate_Int Simple integer validation Localized integer validation
    75.2.20. Ip Supported options for Zend_Validate_Ip Basic usage Validate IPv4 or IPV6 alone
    75.2.21. Isbn Supported options for Zend_Validate_Isbn Basic usage Setting an explicit ISBN validation type Specifying a separator restriction
    75.2.22. LessThan Supported options for Zend_Validate_LessThan Basic usage
    75.2.23. NotEmpty Supported options for Zend_Validate_NotEmpty Default behaviour for Zend_Validate_NotEmpty Changing behaviour for Zend_Validate_NotEmpty
    75.2.24. PostCode Constructor options Supported options for Zend_Validate_PostCode
    75.2.25. Regex Supported options for Zend_Validate_Regex Validation with Zend_Validate_Regex Pattern handling
    75.2.26. Sitemap Validators Sitemap_Changefreq Sitemap_Lastmod Sitemap_Loc Sitemap_Priority Supported options for Zend_Validate_Sitemap_*
    75.2.27. StringLength Supported options for Zend_Validate_StringLength Default behaviour for Zend_Validate_StringLength Limiting the maximum allowed length of a string Limiting the minimal required length of a string Limiting a string on both sides Encoding of values
    75.3. Validator Chains
    75.4. Writing Validators
    75.5. Validation Messages
    75.5.1. Using pre-translated validation messages
    75.5.2. Limit the size of a validation message

    75.1. Introduction

    The Zend_Validate component provides a set of commonly needed validators. It also provides a simple validator chaining mechanism by which multiple validators may be applied to a single datum in a user-defined order.

    75.1.1. What is a validator?

    A validator examines its input with respect to some requirements and produces a boolean result - whether the input successfully validates against the requirements. If the input does not meet the requirements, a validator may additionally provide information about which requirement(s) the input does not meet.

    For example, a web application might require that a username be between six and twelve characters in length and may only contain alphanumeric characters. A validator can be used for ensuring that usernames meet these requirements. If a chosen username does not meet one or both of the requirements, it would be useful to know which of the requirements the username fails to meet.

    75.1.2. Basic usage of validators

    Having defined validation in this way provides the foundation for Zend_Validate_Interface, which defines two methods, isValid() and getMessages(). The isValid() method performs validation upon the provided value, returning TRUE if and only if the value passes against the validation criteria.

    If isValid() returns FALSE, the getMessages() returns an array of messages explaining the reason(s) for validation failure. The array keys are short strings that identify the reasons for validation failure, and the array values are the corresponding human-readable string messages. The keys and values are class-dependent; each validation class defines its own set of validation failure messages and the unique keys that identify them. Each class also has a const definition that matches each identifier for a validation failure cause.

    [Nota] Nota

    The getMessages() methods return validation failure information only for the most recent isValid() call. Each call to isValid() clears any messages and errors caused by a previous isValid() call, because it's likely that each call to isValid() is made for a different input value.

    The following example illustrates validation of an e-mail address:

    $validator = new Zend_Validate_EmailAddress();

    if (
    $validator->isValid($email)) {
    // email appears to be valid
    } else {
    // email is invalid; print the reasons
    foreach ($validator->getMessages() as $messageId => $message) {
    "Validation failure '$messageId': $message\n";

    75.1.3. Customizing messages

    Validate classes provide a setMessage() method with which you can specify the format of a message returned by getMessages() in case of validation failure. The first argument of this method is a string containing the error message. You can include tokens in this string which will be substituted with data relevant to the validator. The token %value% is supported by all validators; this is substituted with the value you passed to isValid(). Other tokens may be supported on a case-by-case basis in each validation class. For example, %max% is a token supported by Zend_Validate_LessThan. The getMessageVariables() method returns an array of variable tokens supported by the validator.

    The second optional argument is a string that identifies the validation failure message template to be set, which is useful when a validation class defines more than one cause for failure. If you omit the second argument, setMessage() assumes the message you specify should be used for the first message template declared in the validation class. Many validation classes only have one error message template defined, so there is no need to specify which message template you are changing.

    $validator = new Zend_Validate_StringLength(8);

    'The string \'%value%\' is too short; it must be at least %min% ' .

    if (!
    $validator->isValid('word')) {
    $messages $validator->getMessages();

    // "The string 'word' is too short; it must be at least 8 characters"

    You can set multiple messages using the setMessages() method. Its argument is an array containing key/message pairs.

    $validator = new Zend_Validate_StringLength(array('min' => 8'max' => 12));

    $validator->setMessages( array(
    Zend_Validate_StringLength::TOO_SHORT =>
    'The string \'%value%\' is too short',
    Zend_Validate_StringLength::TOO_LONG  =>
    'The string \'%value%\' is too long'

    If your application requires even greater flexibility with which it reports validation failures, you can access properties by the same name as the message tokens supported by a given validation class. The value property is always available in a validator; it is the value you specified as the argument of isValid(). Other properties may be supported on a case-by-case basis in each validation class.

    $validator = new Zend_Validate_StringLength(array('min' => 8'max' => 12));

    if (!
    validator->isValid('word')) {
    'Word failed: '
    '; its length is not between '
    ' and '

    75.1.4. Using the static is() method

    If it's inconvenient to load a given validation class and create an instance of the validator, you can use the static method Zend_Validate::is() as an alternative invocation style. The first argument of this method is a data input value, that you would pass to the isValid() method. The second argument is a string, which corresponds to the basename of the validation class, relative to the Zend_Validate namespace. The is() method automatically loads the class, creates an instance, and applies the isValid() method to the data input.

    if (Zend_Validate::is($email'EmailAddress')) {
    // Yes, email appears to be valid

    You can also pass an array of constructor arguments, if they are needed for the validator.

    if (Zend_Validate::is($value'Between', array('min' => 1'max' => 12))) {
    // Yes, $value is between 1 and 12

    The is() method returns a boolean value, the same as the isValid() method. When using the static is() method, validation failure messages are not available.

    The static usage can be convenient for invoking a validator ad hoc, but if you have the need to run a validator for multiple inputs, it's more efficient to use the non-static usage, creating an instance of the validator object and calling its isValid() method.

    Also, the Zend_Filter_Input class allows you to instantiate and run multiple filter and validator classes on demand to process sets of input data. See Zend_Filter_Input. Namespaces

    When working with self defined validators you can give a fourth parameter to Zend_Validate::is() which is the namespace where your validator can be found.

    if (Zend_Validate::is($value'MyValidator', array('min' => 1'max' => 12),
    'FirstNamespace''SecondNamespace')) {
    // Yes, $value is ok

    Zend_Validate allows also to set namespaces as default. This means that you can set them once in your bootstrap and have not to give them again for each call of Zend_Validate::is(). The following code snippet is identical to the above one.

    if (
    Zend_Validate::is($value'MyValidator', array('min' => 1'max' => 12)) {
    // Yes, $value is ok

    if (
    'min' => 1'max' => 12)) {
    // Yes, $value is ok

    For your convenience there are following methods which allow the handling of namespaces:

    • Zend_Validate::getDefaultNamespaces(): Returns all set default namespaces as array.

    • Zend_Validate::setDefaultNamespaces(): Sets new default namespaces and overrides any previous set. It accepts either a string for a single namespace of an array for multiple namespaces.

    • Zend_Validate::addDefaultNamespaces(): Adds additional namespaces to already set ones. It accepts either a string for a single namespace of an array for multiple namespaces.

    • Zend_Validate::hasDefaultNamespaces(): Returns TRUE when one or more default namespaces are set, and FALSE when no default namespaces are set.

    75.1.5. Translating messages

    Validate classes provide a setTranslator() method with which you can specify a instance of Zend_Translate which will translate the messages in case of a validation failure. The getTranslator() method returns the set translator instance.

    $validator = new Zend_Validate_StringLength(array('min' => 8'max' => 12));
    $translate = new Zend_Translate(
    'adapter' => 'array',
    'content' => array(
    Zend_Validate_StringLength::TOO_SHORT => 'Translated \'%value%\''
    'locale' => 'en'


    With the static setDefaultTranslator() method you can set a instance of Zend_Translate which will be used for all validation classes, and can be retrieved with getDefaultTranslator(). This prevents you from setting a translator manually for all validator classes, and simplifies your code.

    $translate = new Zend_Translate(
    'adapter' => 'array',
    'content' => array(
    Zend_Validate_StringLength::TOO_SHORT => 'Translated \'%value%\''
    'locale' => 'en'
    [Nota] Nota

    When you have set an application wide locale within your registry, then this locale will be used as default translator.

    Sometimes it is necessary to disable the translator within a validator. To archive this you can use the setDisableTranslator() method, which accepts a boolean parameter, and translatorIsDisabled() to get the set value.

    $validator = new Zend_Validate_StringLength(array('min' => 8'max' => 12));
    if (!
    $validator->isTranslatorDisabled()) {

    It is also possible to use a translator instead of setting own messages with setMessage(). But doing so, you should keep in mind, that the translator works also on messages you set your own.

    digg delicious meneame google twitter technorati facebook