CodeIgniter Form Validator: Como validar formul�rios em PHP

Porque validar formul�rios no codeigniter?

No desenvolvimento de qualquer tipo de aplicaç�o, n�o podemos considerar que os usu�rios sempre ir�o fornecer valores corretos e v�lidos em formul�rios. Seja por falha humana ou por intenç�es maliciosas, � poss�vel que valores inv�lidos sejam submetidos, comprometendo a integridade dos dados e a segurança da aplicaç�o.

Nesse artigo, aprenderemos como validar os valores informados nos campos de formul�rios utilizando os recursos do framework CodeIgniter, permitindo que apenas dados v�lidos sejam submetidos.

Relacionado: Curso de CodeIgniter

Passo 1: Configurar a view

A view, nesse exemplo, conter� o formul�rio de cadastro de um novo usu�rio, simulando um tipo comum de p�gina que requer a submiss�o de dados em um site. A partir disso, iremos criar, dentro do diret�rio view, uma pasta chamada cadastro e, dentro dela, adicionaremos um arquivo formulario.php com o conte�do da Listagem 1.


01 <?php if(isset($mensagens)) echo $mensagens; ?>
02 <form action="index.php/cadastro/cadastrar"  method="post">
03     <p>Usu�rio :</p>
04     <input type="text" name="usuario" value="" size="50" />
05     <p>Senha :</p>
06     <input type="text" name="senha" value="" size="50" />
07     <p>Confirmar Senha :</p>
08     <input type="text" name="senhaconf" value="" size="50" />
09     <p>E-mail :</p>
10     <input type="text" name="email" value="" size="50" />
11     <div><input type="submit" value="Enviar" /></div>
12 </form>

">Listagem 1. View com o formul�rio de envio do cadastro

Linha 1: Exibimos o retorno da funç�o validation_errors(), que ir� devolver quaisquer mensagens de erro retornadas pelo validador. Caso n�o haja nenhum problema, ela retorna uma string vazia;

Linhas 2 a 12: criamos um formul�rio b�sico para exemplificar as validaç�es.

Nossa view ir� exibir um formul�rio conforme o apresentado na Figura 1.

Figura 1. Formul�rio de registro de novo usu�rio

Passo 2: Implementar o controller

Agora, devemos criar o controller Cadastro e, nele, inserir uma funç�o p�blica para exibir nossa p�gina com o formul�rio. O c�digo dessa funç�o � exposto a seguir:


  public function index() {
      $this->load->view('cadastro/formulario');
  }

Logo ap�s, ainda no controller, precisamos criar a funç�o que ir� receber os dados e valid�-los. Se ocorrerem erros na validaç�o, o controller retorna novamente para a view, que agora ir� exibir a(s) mensagem(ns) de erro. Caso a validaç�o seja aprovada, ser� exibida uma mensagem avisando que o formul�rio foi enviado com sucesso. O c�digo dessa funç�o pode ser visto na Listagem 2.


  01 public function cadastrar() {
  02     $this->load->library('form_validation');
  03     $this->form_validation->set_rules('usuario', 'Usu�rio', 
            'required|min_length[5]|max_length[12]');
  04     $this->form_validation->set_rules('senha', 'Senha', 'required|min_length[7]',
             array('required' => 'Voc� deve preencher a %s.'));
  05     $this->form_validation->set_rules('senhaconf', 'Confirmaç�o de Senha', 
             'required|matches[senha]');
  06     $this->form_validation->set_rules('email', 'Email', 'required|valid_email');
  07     if ($this->form_validation->run() == FALSE) {
  08           $erros = array('mensagens' => validation_errors());
  09           $this->load->view('cadastro/formulario', $erros);
  10     } else {
  11           echo "Formul�rio enviado com sucesso.";
  12     }
  13 }

Listagem 2. Funç�o de validaç�o e recebimento do formul�rio

Linha 2: carregamos a biblioteca respons�vel pela validaç�o;

Linha 3: inserimos uma regra para validar o campo usuario, definindo o campo como obrigat�rio, com no m�nimo de cinco e no m�ximo 12 caracteres;

Linha 4: adicionamos uma regra para validar o campo senha, definindo o campo como obrigat�rio e com no m�nimo sete caracteres;

Linha 5: adicionamos outra regra, agora para validar o campo senhaconf, definindo-o como obrigat�rio e verificando se ele � igual ao campo senha;

Linha 6: inserimos uma regra para validar o campo email, definindo-o como obrigat�rio e verificando se o dado � um e-mail v�lido;

Linhas 7: executamos a validaç�o com o m�todo run(), retornando false quando ocorrer algum problema na validaç�o e true quando todas as informaç�es estiverem corretas;

Linha 8: criamos uma vari�vel para repassar para a view as mensagens de erro;

Linha 9: carregamos a view, passando para ela a vari�vel que cont�m as mensagens de validaç�o;

Linha 11: exibimos a mensagem �Formul�rio enviado com sucesso�, caso nenhum problema de validaç�o seja encontrado.

Ao terminar nosso controller, podemos acessar o projeto pelo navegador e visualizar a p�gina de cadastro exibida na Figura 1. Nesse momento, se tentarmos enviar o formul�rio sem nenhum dado, ser�o exibidas as mensagens de validaç�o conforme a Figura 2.

Figura 2. Mensagens da validaç�o dos campos

Por sua vez, ao simularmos o envio do campo Confirmar Senha com um valor diferente do contido no campo Senha, teremos a mensagem exibida na Figura 3.

Figura 3. Mensagens da validaç�o do campo Confirmar Senha

Passo 3: Entendendo um pouco mais o m�todo set_rules()

O CodeIgniter permite que voc� defina v�rias regras de validaç�o para um determinado campo. Para isso, utilizamos o m�todo set_rules(), como no c�digo a seguir:

$this->form_validation->set_rules('usuario', 'Usu�rio', 'required');

Esse m�todo recebe tr�s par�metros como entrada:

O nome do campo: aquele que � definido no atributo name do input;
O label do campo: um nome amig�vel, que ser� usado na mensagem de erro;
As regras de validaç�o usadas para o campo: A lista de regras pode ser encontrada no site oficial do framework.

Ao concluir essas etapas, teremos nossa aplicaç�o funcionando de forma mais segura, orientando o usu�rio sobre como proceder caso insira informaç�es inv�lidas. Al�m disso, manteremos a integridade do banco de dados, pois somente ser�o aceitas informaç�es v�lidas.

Links �teis

Manual do PHP:
Site oficial do PHP
MYSQL:
Site Oficial do Mysql
PHP no Wikipedia:
Mais informaç�es sobre o Wikipedia

Saiba mais sobre PHP ;)

Introduç�o ao framework PHP CodeIgniter:
Veja neste artigo uma breve apresentaç�o e introduç�o ao framework PHP CodeIgniter, que trabalha sobre o modelo MVC e nos fornece diversas ferramentas para agilizar o desenvolvimento das aplicaç�es.
Trabalhando com controllers no CodeIgniter:
Veja neste artigo como funcionam os controllers no framework PHP CodeIgniter, como criar seus controllers e funç�es.
Utilizando templates no CodeIgniter:
Aprenda como criar e utilizar templates com o framework CodeIgniter e simplifique a construç�o e o reuso de p�ginas em suas aplicaç�es.

Como validar formul�rios no CodeIgniter

Aprenda nesse artigo a utilizar as funções nativas do framework CodeIgniter para validar campos de formulários em PHP.