Validando formulario con clase kumbia validate

De KumbiaPHP Framework Wiki
Saltar a: navegación, buscar

Atención: Este tutorial esta basado en la version Spirit beta2 de KumbiaPHP Framework.

Muchas veces necesitamos usar formularios para que una empresa/persona contacte con nosotros a través de nuestra web. Para validar los datos enviados y evitar un mal uso del mismo, el equipo de Kumbia ha desarrollado una nueva clase llamada Validate desvinculada de las validaciones propias de los modelos basados en ActiveRecord.

Para este tutorial necesitaremos como mínimo un controller, un modelo y una vista. Si descargamos el paquete KumbiaPHP del GitHub podemos usar el controller por defecto y su vista y sólo nos quedaría crear el modelo.

Modelo: sendform.php[editar]

  1. class SendForm {
  2.  
  3. 	private function reglas() {
  4.  
  5. 		return array(
  6. 			'NombreCompleto' => array(
  7. 				'required'=>array('error'=>'Indique su nombre.'),
  8. 				'alpha' =>array('error'=>'Nombre incompleto o incorrecto.')
  9. 			),
  10. 			'Email' => array(
  11. 				'required'=>array('error'=>'Indique su email.'),
  12. 				'email' => array('error'=>'Email incorrecto.')
  13. 			),
  14. 			'Movil' => array(
  15. 				'required'=>array('error'=>'Indique su teléfono / móvil.'),
  16. 				'length' => array('min'=>'9','max'=>'17','error'=>'Teléfono / móvil incorrecto'),
  17. 				'pattern' => array('regexp'=>'/^\+(?:[0-9] ?){6,14}[0-9]$/','error'=>'Teléfono incorrecto. Formato ejemplo. +34 862929929')
  18. 			),
  19. 			'Asunto' => array(
  20. 				'required'=>array('error'=>'Indique un asunto.'),
  21. 			),
  22. 			'Mensaje' => array(
  23. 				'required'=>array('error'=>'Indique un mensaje.'),
  24. 				'length'=>array('min'=>100, 'error'=>'Si es posible, concrete más en su mensaje.'),
  25. 			)
  26. 		);
  27.  
  28.  
  29.  
  30. 	}
  31.  
  32.  
  33. 	// Envio de datos para generar email
  34. 	public function enviar($datos) {
  35.  
  36. 		$validador = new Validate($datos, $this->reglas() );
  37. 		if (!$validador->exec()) {
  38. 			$validador->flash();
  39. 		} else {
  40.  
  41. 			// Enviar email
  42.  
  43. 		}
  44.  
  45. 	}
  46.  
  47. }

Vista: index.phtml[editar]

En nuestra vista debemos añadir los controles para los campos del formulario. Hemos usado la nomenclatura contactar.<field> para agrupar en una única variable los datos del formulario.

  1. <div class="container">
  2. <?php echo Form::open() ?>
  3. <?php View::content() ?>
  4. <fieldset><legend>Contactar</legend>
  5. <?php echo Form::label('Nombre completo:', 'contactar_NombreCompleto') ?> <?php echo Form::text('contactar.NombreCompleto') ?>
  6. <?php echo Form::label('Email:', 'contactar_Email') ?> <?php echo Form::text('contactar.Email') ?>
  7. <?php echo Form::label('Teléfono / Móvil:', 'contactar_Movil') ?> <?php echo Form::text('contactar.Movil') ?>
  8. <?php echo Form::label('Mensaje:', 'contactar_Mensaje') ?> <?php echo Form::textarea('contactar.Mensaje') ?>
  9. <?php echo Form::submit('Enviar') ?>
  10. </fieldset>
  11. <?php echo Form::close() ?>
  12. </div>

Controller: index_controller.php[editar]

  1. Load::model('sendform');
  2. class IndexController extends AppController
  3. {
  4.  
  5.     public function index()
  6.     {
  7.         // Verificamos que se envian datos desde el formulario
  8. 	if (Input::hasPost('contactar')) {
  9.  
  10. 		$form = new SendForm();
  11. 		// Procesamos envio de formulario
  12. 		if ($form->enviar(Input::post('contactar'))) {
  13. 			// Si se envia correctamente, limpiamos el formulario para evitar reenvios
  14. 			Input::delete('contactar');
  15. 		} 
  16.  
  17. 	}
  18.  
  19.     }
  20.  
  21. }

Notas finales[editar]

Este tipo de validaciones a nivel de servidor son una excelente herramienta para asegurarnos que los datos llegan correctamente. Validate también se puede combinar con la librería Filter para evitar inyecciones de código o ataques malicioso basados en formularios.