Validación de Datos¶

rule¶

El índice ‘rule’ define el método de validación y acepta un sólo valor o un arreglo. El valor para ‘rule’ especificado puede ser el nombre de un método en tu modelo, un método de la clase core Validation, o una expresión regular. Para un completo listado de todas las reglas incorporadas ver la sección llamada «Reglas de Validación Incorporadas».

Si la regla no requiere parámetros, ‘rule’ puede ser un sólo valor, por ejemplo:

var $validate = array(
    'login' => array(
        'rule' => 'alphaNumeric'
    )
);

Si la regla requiere algunos parámetros (como max, min o range), entonces ‘rule’ debería ser un arreglo:

var $validate = array(
    'password' => array(
        'rule' => array('minLength', 8)
    )
);

Recuerda, el índice ‘rule’ es requerido para la definición de reglas basadas en arreglos.

required¶

Este índice debería tener asignado un valor booleano. Si ‘required’ es true, el campo debe estar presente en el arreglo de datos. Por ejemplo, si la regla de validación ha sido definida de la siguiente manera:

var $validate = array(
    'login' => array(
        'rule' => 'alphaNumeric',
        'required' => true
    )
);

Los datos enviados al método save() del modelo deben contener un valor para el campo login. Si no es así, la validación falla (la regla no se cumple). El valor por defecto para este índice es un false booleano.

Si el índice login están presente pero no tiene un valor asignado, la validación será exitosa. Setear ‘required’ a true sólo verifica que el índice del campo este presente.

allowEmpty¶

Al índice allowEmpty se le debería asignar un valor booleano. Si allowEmpty es false, los datos pasados al método save() del modelo deben incluir el campo a un valor no-vacío para ese campo. Cuando se deja en true, un campo vacío pasará exitosamente la validación de ese campo.

El valor por defecto de allowEmpty es null. Esto significa que el campo siempre procesará las reglas de validación incluyendo la ejecución de funciones de validación propias.

on¶

El índice ‘on’ puede ser seteado con uno de los siguientes valores: ‘update’ o ‘create’. Esto provee un mecanismo que permite que cierta regla sea aplicada ya sea durante la creación de un nuevo registro, o durante la actualización de un registro.

Si la regla fue definida como ‘on’ => ‘create’, entonces la regla sólo será verificada durante la creación de un nuevo registro. De igual manera, si es definida como ‘on’ => ‘update’, la regla sólo será verificada durante la actualización de un registro.

El valor por defecto de ‘on’ es null. Cuando ‘on’ es null, la regla será verificada durante la creación y actualización de un registro.

message¶

El índice ‘message’ permite definir un mensaje de error de validación para la regla:

var $validate = array(
    'password' => array(
        'rule' => array('minLength', 8),
        'message' => 'Password debe tener a lo menos 8 caracteres'
    )
);

last¶

Asignar 'last' a true provocará que el validador se detenga en la regla si llegara a fallar en vez de continuar con la siguiente regla. Ésto es útil si quieres que la validación se detenga si el campos es notEmpty en un campo multi-regla.

var $validate = array(
    'username' => array(
        'usernameRule-1' => array(
            'rule' => 'notEmpty',
            'message' => 'Por favor, introduce el nombre de usuario.',
            'last' => true
         ),
        'usernameRule-2' => array(
            'rule' => array('minLength', 8),
            'message' => 'Longitud mímima de 8 caracteres.'
        )
    )
);

El valor predeterminado de 'last' es false.

alphaNumeric¶

Los datos para el campo deben contener sólo letras y números.

var $validate = array(
    'login' => array(
        'rule' => 'alphaNumeric',
        'message' => 'Los nombres de usuario deben contener sólo letras y números.'
    )
);

between¶

El largo de los datos para el campo debe estar dentro de un rango numérico específico. Se debe indicar un valor mínimo y máximo.

var $validate = array(
    'password' => array(
        'rule' => array('between', 5, 15),
        'message' => 'Las contraseñas deben tener un largo entre 5 y 15 caracteres.'
    )
);

blank¶

Esta regla es usada para asegurar que el campo es dejado en blanco o con sólo espacios en blanco como su valor. Los espacios en blanco incluyen los caracteres de la barra espaciadora, tabulador, retorno de carro y nueva línea.

var $validate = array(
    'id' => array(
        'rule' => 'blank',
        'on' => 'create'
    )
);

boolean¶

El campo debe contener un valor booleano. Los valores aceptados son “true” o “false”, los enteros 0 o 1 y las cadenas «0» o «1».

var $validate = array(
    'myCheckbox' => array(
        'rule' => array('boolean'),
        'message' => 'Valor incorrecto en myCheckbox'
    )
);

cc¶

Esta regla es usada para verificar si los datos corresponden a un número de tarjeta de credito válido. Acepta tres parámetros: ‘type’, ‘deep’ y ‘regex’.

El ‘type’ puede ser ‘fast’, ‘all’ o cualquiera de los siguientes:

• bankcard

• diners

• disc

• electron

• enroute

• jcb

• maestro

• mc

• solo

• switch

• visa

• voyager

Si ‘type’ es dejado en ‘fast’, se validan los datos contra el formato numérico de las principales tarjetas de crédito. También se puede dejar ‘type’ como un arreglo con todos los tipos de validaciones que se quiere satisfacer.

El índice ‘deep’ debería dejarse con un valor booleano. Si es verdadero, la validación usará el algoritmo de Luhn para tarjetas de crédito (https://en.wikipedia.org/wiki/Luhn_algorithm). Por defecto el valor se asume como falso.

El índice ‘regex’ permite indicar una expersión regular propia que será usada para validar el número de tarjeta de credito.

var $validate = array(
    'ccnumber' => array(
        'rule' => array('cc', array('visa', 'maestro'), false, null),
        'message' => 'El número de tarjeta de crédito que ha suministrado no es válido.'
    )
);

comparison¶

Esta regla es usada para comparar valores numéricos. Soporta “is greater”, “is less”, “greater or equal”, “less or equal”, “is less”, “equal to”, y “not equal”. A continuación algunos ejemplos:

var $validate = array(
    'age' => array(
        'rule' => array('comparison', '>=', 18),
        'message' => 'Debe tener al menos 18 años para calificar.'
    )
);

var $validate = array(
    'age' => array(
        'rule' => array('comparison', 'greater or equal', 18),
        'message' => 'Debe tener al menos 18 años para calificar.'
    )
);

date¶

Esta regla asegura que los datos enviados esten en un formato de fecha válido. Un único parámetro (que puede ser un arreglo) puede ser pasado y que será usado para verificar el formato de la fecha indicada. El valor del parámetro puede ser uno de los siguientes formatos:

• ‘dmy’ por ejemplo 27-12-2006 o 27-12-06 (los separadores pueden ser espacio, punto, guion, slash)

• ‘mdy’ por ejemplo 12-27-2006 or 12-27-06 (los separadores pueden ser espacio, punto, guion, slash)

• ‘ymd’ por ejemplo 2006-12-27 or 06-12-27 (los separadores pueden ser espacio, punto, guion, slash)

• ‘dMy’ por ejemplo 27 December 2006 o 27 Dec 2006

• ‘Mdy’ por ejemplo December 27, 2006 o Dec 27, 2006 (la coma es opcional)

• ‘My’ por ejemplo (December 2006 o Dec 2006)

• ‘my’ por ejemplo 12/2006 o 12/06 (los separadores pueden ser espacio, punto, guion, slash)

Si no especifica ningún índice, se usará el índice por defecto ‘ymd’.

var $validate = array(
    'born' => array(
        'rule' => 'date',
        'message' => 'Ingrese una fecha válida usando el formato AA-MM-DD.',
        'allowEmpty' => true
    )
);

Mientras que muchos almacenes de datos (motores de bases de datos) requieren cierto formato de datos, podrias considerar aceptar una amplia variedad de formatos de fechas y luego convertirlos, en vez de forzar a los usuarios a ingresar cierto formato. Entre más trabajo puedas hacer por tus usuarios, mejor.

decimal¶

Esta regla asegura que el dato es un número decimal válido. Se puede pasar un parámetro para especificar la cantidad de dígitos requeridos después del punto decimal. Si no se pasa ningún parámetro, el dato será validado como un número de punto flotante científico, que causará que la validación no sea satisfecha si es que no se encuentra ningún dígito después del punto decimal.

var $validate = array(
    'price' => array(
        'rule' => array('decimal', 2)
    )
);

email¶

Esta regla verifica que el dato sea una dirección de correo electrónico válida. Al pasar un valor booleano verdadero como segundo parámetro se tratará también de verificar que el host de la dirección sea válido.

var $validate = array('email' => array('rule' => 'email'));

var $validate = array(
    'email' => array(
        'rule' => array('email', true),
        'message' => 'Por favor indique una dirección de correo electrónico válida.'
    )
);

equalTo¶

Esta regla asegura que el valor sea equivalente a, y del mismo tipo que el valor indicado.

var $validate = array(
    'food' => array(
        'rule' => array('equalTo', 'cake'),
        'message' => 'El valor debe ser el string cake'
    )
);

extension¶

Esta regla verifica que la extensión de archivo sea como .jpg o .png. Para permitir múltiples extensiones estas se deben pasar dentro de un arreglo.

var $validate = array(
    'image' => array(
        'rule' => array('extension', array('gif', 'jpeg', 'png', 'jpg'),
        'message' => 'Por favor indique una imágen válida.'
    )
);

file¶

Esta sección aún tiene que ser escrita, si tienes una idea de qué poner aqui, por favor usa los links y déjanos saber tu sugerencia!

ip¶

Esta regla asegura que haya sido ingresada una dirección IPv4 válida.

var $validate = array(
    'clientip' => array(
        'rule' => 'ip',
        'message' => 'Por favor ingrese una dirección IP válida.'
    )
);

isUnique¶

El dato para este campo debe ser único, no puede ser usado por ningún otro registro.

var $validate = array(
    'login' => array(
        'rule' => 'isUnique',
        'message' => 'Este nombre de usuario ya ha sido asignado.'
    )
);

minLength¶

Esta regla asegura que el dato cumple con un requisito de largo mínimo.

var $validate = array(
    'login' => array(
        'rule' => array('minLength', '8'),
        'message' => 'Los nombres de usuario deben tener un largo de al menos 8 caracteres.'
    )
);

maxLength¶

Esta regla asegura que el dato siempre esté dentro del requisito de largo máximo.

var $validate = array(
    'login' => array(
        'rule' => array('maxLength', '15'),
        'message' => 'Los nombres de usuario no pueden tener un largo mayor a 15 caracteres.'
    )
);

money¶

Esta regla asegura que el valor sea una cantidad en formato monetario válido.

El segundo parámetro define dónde se ubica el símbolo: left/right (izquierda/derecha).

var $validate = array(
    'salary' => array(
        'rule' => array('money', 'left'),
        'message' => 'Por favor ingrere una cantidad monetaria válida.'
    )
);

multiple¶

Empleado para validar campos input select multiple. Soporta los paramentros «in», «max» y «min».

var $validate = array(
    'multiple' => array(
        'rule' => array('multiple', array('in' => array('foo', 'bar'), 'min' => 1, 'max' => 3)),
        'message' => 'Por favor seleccione una, dos o tres opciones'
    )
);

inList¶

Esta regla asegura que el valor está dentro de un conjunto dado. Necesita de un arreglo de valores. El valor es válido si coincide con uno de los valores del arreglo indicado.

Example:

var $validate = array(
  'function' => array(
    'allowedChoice' => array(
        'rule' => array('inList', array('Foo', 'Bar')),
        'message' => 'Ingreso Foo o ingrese Bar.'
    )
  )
);

numeric¶

Verifica si el dato ingresado es un número válido.

var $validate = array(
    'cars' => array(
        'rule' => 'numeric',
        'message' => 'Por favor indique la cantidad de vehículos.'
    )
);

notEmpty¶

Regla básica para asegurar que un campo no este vacío.

var $validate = array(
    'title' => array(
        'rule' => 'notEmpty',
        'message' => 'Este campo no puede quedar vacío.'
    )
);

phone¶

Phone valida números telefónicos de EE.UU. Si quieres validar números telefónicos que no sean de EE.UU. puedes proveer una expresión regular como segundo parámetro para cubrir formatos adicionales.

var $validate = array(
    'phone' => array(
        'rule' => array('phone', null, 'us')
    )
);

postal¶

Postal es usado para validar códigos ZIP de EE.UU. (us), Canada (ca), Reino Unido (uk), Italia (it), Alemania (de) y Bélgica (be). Para otros formatos ZIP puedes proveer una expersión regular como segundo parámetro.

var $validate = array(
    'zipcode' => array(
        'rule' => array('postal', null, 'us')
    )
);

range¶

Esta regla asegura que el valor esté dentro de un rango dado. Si no se indica un rango, la regla va a verificar si el valor es un número finito válido en la actual plataforma.

var $validate = array(
    'number' => array(
        'rule' => array('range', 0, 10),
        'message' => 'Por favor ingrese un número entre 0 y 10'
    )
);

El ejemplo de arriba aceptará cualquier valor mayor a 0 (por ejemplo 0.01) y menor a 10 (por ejemplo 9.99).

ssn¶

Ssn valida los números de seguridad social de EE.UU. (us), Dinamarca (dk), y los Paises Bajos (nl). Para otros formatos de números de seguridad social puedes proveer una expersión regular.

var $validate = array(
    'ssn' => array(
        'rule' => array('ssn', null, 'us')
    )
);

url¶

Esta regla verifica formatos de URL válidos. Soporta los protocolos http(s), ftp(s), file, news, y gopher.

var $validate = array(
    'website' => array(
        'rule' => 'url'
    )
);

Validación Personalizada Mediante Expresiones Relugares¶

Si la técnica de validación que necesitas usar puede ser completada usando expresiones regulares, puedes definir una expresión personalizada como una regla de validación de un campo.

var $validate = array(
    'login' => array(
        'rule' => array('custom', '/^[a-z0-9]{3,}$/i'),
        'message' => 'Sólo letras y enteros, mínimo 3 caracteres'
    )
);

El ejemplo de arriba verifica si login contiene sólo letras y enteros, con un largo mínimo de tres caracteres.

Validación Mediante Métodos Personalizados¶

Algunas veces revisar los datos usando expresiones regulares no es suficiente. Por ejemplo, si quieres asegurar que un código promocional sólo pueda ser usado 25 veces, necesitas agregar una función de validación personalizada, como se muestra más abajo:

<?php
class User extends AppModel {
    var $name = 'User';

    var $validate = array(
        'promotion_code' => array(
            'rule' => array('limitDuplicates', 25),
            'message' => 'Este código ha sido usado demasiadas veces.'
        )
    );

    function limitDuplicates($data, $limit){
        $existing_promo_count = $this->find( 'count', array('conditions' => $data, 'recursive' => -1) );
        return $existing_promo_count < $limit;
    }
}
?>

Si quieres pasar parámetros a tu función de validación personalizada, agrega elementos extra al arreglo ‘rule’ y trátalos como parámetros extra (despúes del parámetro principal $data) en tu función personalizada.

Tu función de validación personalizada puede estar en el modelo (como en el ejemplo de arriba), o en un behavior implementado por el modelo. Esto incluye los modelos mapeados.

Notar que los métodos del model/behavior son verificados primero, antes de buscar un método en la clase Validation. Esto significa que puedes sobreescribir métodos de validación existentes (como por ejemplo alphaNumeric()) en el nivel de aplicación (agregando el método a AppModel), o en el nivel de modelo.