1. Utilizar la función error del FormHelper (realizando la llamada desde la vista) o la función invalidate del modelo (si realizamos la validación manual desde el controlador).
2. Utilizar el propio modelo como fuente de estos mensajes de error.

En el primero de los casos utilizaríamos el siguiente código para la vista y el controlador respectivamente:

$form->error('campo', __('MENSAJE_ERROR', true));
$this->Modelo->invalidate('campo', __('MENSAJE_ERROR', true));

y de esta forma buscaría esa clave del mensaje en el fichero de idioma.

La ventaja de hacerlo desde el modelo y no desde las vistas es que nos permite unificar los mensajes de error en cada campo y evitar la repetición de este código cuando estemos en formularios distintos que incluyan los mismos campos. El inconveniente es que en el modelo no se permite la utilización de la función __() de CakePHP.

Para solucionar este problema será necesario modificar la clase AppModel de la que extienden todos los modelos y que a su vez extiende de Model para redefinir la función invalidate (podemos ver la definición original en el api de CakePHP). Así, el fichero cake/libs/model/app_model.php quedaría como se muestra a continuación:

<?php
class AppModel extends Model {
   function invalidate($field, $value = true) {
      if (!is_array($this->validationErrors)) {
         $this->validationErrors = array();
      }
      $this->validationErrors[$field] = __($value, true);
   }
}
?>

Con este simple cambio, tenemos los mensajes de error del modelo internacionalizados.

Validaciones con campos vacíos

Hasta hoy, no habíamos encontrado la forma de validar formatos de campos, permitiendo que se encuentren vacíos, directamente en el modelo. Lo que hacíamos era hacer este tipo de comprobaciones manualmente, rompiendo un poco la flexibilidad que nos ofrece CakePHP para hacer las validaciones directamente en el modelo y sin volver a preocuparnos de ellas.

Ahora ya descubrimos la manera de hacerlo. Es una cosa muy simple que habíamos pasado por alto. Simplemente tenemos que pasar un parámetro a la función de validación, de la manera siguiente:

var $validate = array(
   'email' => array(
   'valid' => array( 'rule' => array('email'),
                             'allowEmpty' => true,
                             'message' => 'Formato email inválido')
                             )
              );

Validación a medida

En el modelo introduciremos el siguiente código:

var $validate = array(
    'campo' => array(
                  'valid' => array( 'rule' => 'reglaPropia',
                              'param1'=>'valor',
                              'message' => 'Mensaje de salida')
                              )
                    );

function reglaPropia($value, $params)
{
   $valid = false;
   if (!condicion){
      // Asignamos el valor a $valid en función de la condición que queramos establecer
   }
   return $valid;
}

A la función creada le hemos pasado dos argumentos, aunque el segundo podríamos no ponerlo si no es necesario. Ambos serán arrays, de manera que si queremos acceder al valor del campo a validar tendremos que leer $value['campo'] y para acceder a los parámetros $params['param1'] , pudiendo introducir tantos parámetros como sea necesario.

En esta función podemos utilizar también las funciones de validación de CakePHP. Por ejemplo:

$valid = Validation::custom($value['campo'], $params['param1']);

Al tema… Lo primero que hay que hacer es crear las reglas de validación en el modelo, lo haremos en la variable $validate, introduciendo ya aquí los mensajes de error para no tener que preocuparnos en cada formulario de especificarlos.
En el siguiente ejemplo vemos varias reglas sencillas para un modelo que sólo tiene dos campos que queramos validar: nombre y password.

var $validate = array(
   'nombre' => array(
      'valid' => array('rule' => array('alphaNumeric'),
                       'message' => 'Nombre debe ser alfanumérico'),
      'required' => array('rule' => array('minLength', '1'),
                            'message' => 'Nombre obligatorio')),
   'password'   => array(
      'required' => array('rule' => array('minLength', '1'),
                            'message' => 'Password obligatorio'),
      'length' => array('rule' => array('minLength', 6),
                            'message' => 'Longitud mínima del password de 6 caracteres')));

Vemos ya en este ejemplo algunas de las distintas reglas que existen en CakePHP 1.2, pero tenemos muchas más. Son las siguientes:

• alphaNumeric: campos alfanuméricos.
• between: aunque pueda parecer que valida que un número esté en un rango, lo que en realidad hace es comprobar que la longitud de una cadena esté en un rango:

  'rule' => array('between', minVal, maxVal)

• blank: valida que el campo esté en blanco o contenga sólo espacios o tabulaciones.
• cc: valida que una tarjeta de crédito sea correcta:

  'rule' => array('cc', array('tipo')), donde tipo puede ser: visa, maestro...

• comparison: para comparar valores numéricos:

  'rule' => array('comparison', 'tipo', val), donde tipo puede ser: "is greater”,“is less”, “greater or equal”, “less or equal”, “is less”, “equal to”, y “not equal”;y sus equivalentes >, <, >= ...

• custom: sirve para definir tus propias expresiones regulares:

  'rule' => array('custom', 'expresion_regular')

• date: valida una fecha, recibe como parámetro el formato:

  'rule' => array('date', 'ymd')

• decimal: valida un número decimal recibiendo el número de decimales que tiene que tener:

  'rule' => array('decimal', num_decimales)

• email: sirve para verificar que una dirección de email tiene el formato adecuado.
• equalTo: para comprobar que un campo sea exactamente igual a otro que se le pasa como parámetro:

  'rule' => array('equalTo', val)

• extension: sirve para validar que el campo tiene la extensión o extensiones que se le indican como parámetro:

  'rule' => array('extension', array('gif', 'jpeg', 'png', 'jpg'))

• file: permite comprobar que es un fichero. Todavía no está implementada.
• ip: valida que el campo es una IPv4.
• minLength y maxLength: sirve para validar que el campo tiene la longitud mínima y máxima, respectivamente, que se le pasa como parámetro:

  'rule' => array('minLength', val)  o  'rule' => array('maxLength', val)

• money: valida que sea una cantidad monetaria. Se le pasa como parámetro ‘left’ o ‘right’, en función de dónde le digamos que está el símbolo monetario.
• multiple: para validar selects múltiples. Aún no está implementado.
• numeric: se comporta igual que la función de PHP is_numeric().
• phone: para validar un número de teléfono, se le pasa una expresión regular o null y el código del país. De momento sólo está implementado para Estados Unidos, para el resto se debe poner la expresión regular.

  'rule' => array('phone', null, 'us')

• postal: igual que el anterior en sintaxis pero para validar códigos postales. En este caso, está implementado para Estado Unidos(us), Reino Unido(uk), Canada(ca), Italia(it) y Alemania (de).
• ssn: lo mismo que los dos anteriores pero para números de la seguridad social. Implementado para Estados Unidos(us), Dinamarca(dk) y Holanda(nl).
• url: para validar urls.

Y ya sólo queda hacer el formulario que incluya validación. Podemos hacer uso para ello de una nueva función que viene implementada en el Form Helper, inputs:

echo $form->inputs(array('legend'=>'Datos personales',
                  'nombre' => array('label'=>'Nombre *', 'size'=>32),
                  'password' => array('label'=>'Password *', 'type'=>'password')));

De esta forma ya se encarga CakePHP de mostrar los errores automáticamente, al hacer el save (si no le especificamos que no nos lo haga) o bien al llamar explícitamente a la función validates del modelo. Si optas por esta segunda opción, la forma de hacer la llamada cambió con la nueva versión de Cake, y ahora se realiza de la manera siguiente:

$this->Modelo->set($this->data);
$this->Modelo->validates();

Yo he optado, en el caso de no poder usar la función inputs, por no usar ninguna de las funciones del Form Helper select, dateTime, radio… y utilizar para todo la función input, a la que se le pueden pasar atributos tipo type, label, before, options, error… (para más información ver la línea 491 del Form Helper). De esta forma me muestra automáticamente los errores.

Por supuesto existe muchas más información en la propia API de CakePHP 1.2, aunque una información menos densa la encontramos en la Bakery, interesante sobre todo por los comentarios finales de la gente, que aportan muchas ideas.