Validando formulario con clase kumbia validate

Atención: Este tutorial esta basado en la version 1.x 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

class SendForm {
	
	private function reglas() {
	
		return array(
			'NombreCompleto' => [
				'required' => ['error' => 'Indique su nombre.'],
				'alpha'    => ['error' => 'Nombre incompleto o incorrecto.']
			],
			'Email' => [
				'required' => ['error' => 'Indique su email.'],
				'email'    => ['error' => 'Email incorrecto.']
			],
			'Movil' => [
				'required' => ['error' => 'Indique su teléfono / móvil.'],
				'length'   => ['min' => '9',
                                'max' => '17',
                                'error' => 'Teléfono / móvil incorrecto'],
				'pattern'  => ['regexp' => '/^\+(?:[0-9] ?){6,14}[0-9]$/', 
                                'error'  => 'Teléfono incorrecto. Formato ejemplo. +34 862929929']
			],
			'Asunto' => [
				'required' => ['error' => 'Indique un asunto.'],
			],
			'Mensaje' => [
				'required' => ['error' => 'Indique un mensaje.'],
				'length'   => ['min' => 100,
                                'error' => 'Si es posible, concrete más en su mensaje.'],
			]
		);

	}


    // Envio de datos para generar email
    public function enviar($datos) {
    		
        $validador = new Validate($datos, $this->reglas() );
        if (!$validador->exec()) {
                $validador->flash();
                return false;
        }
    		
        // Enviar email
    
    }

}

Vista: index.phtml

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.

<div class="container">
<?= Form::open() ?>
<?php View::content() ?>
<fieldset><legend>Contactar</legend>
<label required>Nombre completo:
<?= Form::text('contactar.NombreCompleto') ?>
</label>
<label required>Email:
<?= Form::text('contactar.Email') ?>
</label>
<label required>Teléfono / Móvil:
<?= Form::text('contactar.Movil') ?>
</label>
<label required>Mensaje:
<?= Form::textarea('contactar.Mensaje') ?>
</label>
<?= Form::submit('Enviar') ?>
</fieldset>
<?= Form::close() ?>
</div>

Controller: index_controller.php

class IndexController extends AppController
{

    public function index()
    {
        // Verificamos que se envían datos desde el formulario
	if (Input::hasPost('contactar')) {
			
		$form = new SendForm();
		// Procesamos envio de formulario
		if ($form->enviar(Input::post('contactar'))) {
			// Si se envía correctamente, limpiamos el formulario para evitar reenvíos
			Input::delete('contactar');
		} 
			
	}
		
    }

}

Notas finales

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.