CodeIgniter formulário de cadastro

8 de abril de 2009

Estava dando uma olhada em outros frameworks php, CodeIgniter me chamou bastante atenção. Documentação desatualizada mas em português, simplicidade, de fácil instalação, curva de aprendizado rápida.

Percebi que não iria me preocupar em rodá-lo localmente, igual acontece com o Zend Framework, porque instalar o CodeIgniter é como tirar doce da boca de criança.

Caso tenha dúvidas sobre o que é Framework ou MVC, eu escrevi um resumo abaixo:

Framework torna fácil e simples o processo de construir aplicações web, agiliza o trabalho do programador e o mesmo já não precisa se preocupar com os mínimos detalhes da aplicação.

MVC (Model – View – Controller), é  um padrão de arquitetura de software, a idéia é separar a lógica da aplicação das views, facilitando a manutenção de código.

Model: Contém a lógica da aplicação.

View: Se preocupa somente em renderizar os dados.

Controller: Processa e responde a eventos, é onde recebemos algo enviado pelos usuários e retornamos os resultados nas views .

Hora de botar a mão na massa.

Banco de dados:

SET @OLD_UNIQUE_CHECKS=@@UNIQUE_CHECKS, UNIQUE_CHECKS=0;
SET @OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS=0;
SET @OLD_SQL_MODE=@@SQL_MODE, SQL_MODE='TRADITIONAL';

CREATE SCHEMA IF NOT EXISTS estudo DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci ;
USE estudo;

-- -----------------------------------------------------
-- Table `mydb`.`agenda`
-- -----------------------------------------------------
CREATE  TABLE IF NOT EXISTS estudo.agenda (
`id` INT(3) NOT NULL AUTO_INCREMENT ,
`nome` VARCHAR(40) NOT NULL ,
`email` VARCHAR(40) NOT NULL ,
`telefone` INT(10) NOT NULL ,
`celular` INT(10) NOT NULL ,
PRIMARY KEY (`id`) )
ENGINE = MyISAM
DEFAULT CHARACTER SET = utf8
COLLATE = utf8_general_ci;

SET SQL_MODE=@OLD_SQL_MODE;
SET FOREIGN_KEY_CHECKS=@OLD_FOREIGN_KEY_CHECKS;
SET UNIQUE_CHECKS=@OLD_UNIQUE_CHECKS;

Faça download do CodeIgniter e extraia os arquivos em seu servidor, acesse seu site, irá aparecer uma mensagem de boas vindas (moleza não é) .

Abra o arquivo application/config/config.php e altere a sua url base.

/*
|--------------------------------------------------------------------------
| Base Site URL
|--------------------------------------------------------------------------
|
| URL to your CodeIgniter root. Typically this will be your base URL,
| WITH a trailing slash:
|
|    http://example.com/
|
*/
$config['base_url']    = "http://127.0.0.1/index.php/";

Abra o arquivo application/config/database.php e preencha as configurações do seu banco de dados.

$active_group = "default";
$active_record = TRUE;

$db['default']['hostname'] = "localhost";
$db['default']['username'] = "root";
$db['default']['password'] = "";
$db['default']['database'] = "estudo";
$db['default']['dbdriver'] = "mysql";
$db['default']['dbprefix'] = "";
$db['default']['pconnect'] = TRUE;
$db['default']['db_debug'] = TRUE;
$db['default']['cache_on'] = FALSE;
$db['default']['cachedir'] = "";
$db['default']['char_set'] = "utf8";
$db['default']['dbcollat'] = "utf8_general_ci";

Controller:

<?php
// application/controllers/agenda.php
class Agenda extends Controller
{
// Construtor da classe Agenda
function __construct()
{
parent::Controller();
// Carrega o helper url
$this->load->helper('url');
// Carrega a biblioteca de validação de formulário
$this->load->library('form_validation');
}

function index()
{
// Renderiza a view application/views/index.php
$this->load->view('index');
}

function salvar()
{
// Se o preenchimento do formulário não for feito corretamente, é
// renderizada a mesma view
if($this->form_validation->run() == FALSE)
// Renderiza a view application/views/index.php
$this->load->view('index');
else {
// Carrega o meu Model Agenda e estabelece a conexão com o banco de dados
$this->load->model('Agenda_Model','',TRUE);

// Caso o retorno seja diferente de 0, já temos esse registro
// e não devemos fazer o cadastro novamente

if($this->Agenda_Model->temRegistroRepetido()!=0){
$data['Agenda_ModelError'] = 'Por favor digite outro nome, pois o mesmo já existe no banco de dados.';

// Renderiza a view application/views/index.php passando a variável data
// como parâmetro
$this->load->view('index', $data);
}
else{ // Salva o registro
$this->Agenda_Model->salvar();
// Renderiza a view application/views/sucesso.php
$this->load->view('sucesso');
}
}
}
}

Model:

<?php
// application/models/agenda_model.php
class Agenda_Model extends Model
{
function __construct()
{
parent::Model();
}

function salvar()
{
// $this->input->post('campo'); Captura os valores do input enviados
// via post, pode ser utilizado também $_POST['campo'];
// porém não é recomendado
$this->nome     = $this->input->post('nome');
$this->email    = $this->input->post('email');
$this->telefone = $this->input->post('ddd_tel').$this->input->post('telefone');
$this->celular  = $this->input->post('ddd_cel').$this->input->post('celular');

return $this->db->insert('agenda', $this); // Salva
}

// Verifica se tem registro repetido no banco de dados
// filtro sendo feito pelo nome
function temRegistroRepetido()
{
$this->db->where('nome', $this->input->post('nome'));

$this->db->from('agenda');

return $this->db->count_all_results();
}
}

View:

Index.php

<?// application/views/index.php ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Exemplo de formulário de cadastro</title>
<meta name="description" content="Exemplo de formulário de cadastro." />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="language" content="pt-br" />
<meta name="author" content="Wellington Rocha" />
<style type='text/css'>
/*
Neste caso, foi adicionado a folha de estilo diretamente na página, mas
não é padrão desenvolver um projeto e adicionar o css desta forma.
*/
body { margin: 0; padding: 0; font-family: Lucida Grande, Verdana, Geneva, Sans-serif; font-size: 11px; color: #4F5155; }

form#cadastro { width: 400px;  margin: 0 auto;}

form#cadastro label, input { display: block; }

form#cadastro input{ margin-top: 10px; }

form#cadastro label{ margin-top: 5px; }
</style>
</head>
<body>
<form action="<?=base_url()?>agenda/salvar" method="post" name="cadastro" id="cadastro">
<fieldset>
<legend>Agenda</legend>
<?//Mostra os erros de validações no formulário?>
<div id="alerta">
<?=validation_errors()?>
<?if(isset($Agenda_ModelError)):?>
<p><?=$Agenda_ModelError?></p>
<?endif;?>
</div>
<label for="nome">Nome (*):</label>
<?// set_value('campo') re-popula os dados do formulário quando ocorre ?>
<?// algum erro ?>
<input type="text" name="nome" id="nome" value="<?=set_value('nome')?>" />
<label for="email">Email:</label>
<input type="text" name="email" id="email" value="<?=set_value('email')?>" />
<label for="ddd_tel">DDD - (Númerico) (*):</label>
<input type="text" name="ddd_tel" id="ddd_tel" size="2" value="<?=set_value('ddd_tel')?>" />
<label for="telefone">Telefone - (Númerico) (*):</label>
<input type="text" name="telefone" id="telefone" size="8" value="<?=set_value('telefone')?>" />
<label for="ddd_cel">DDD - (Númerico):</label>
<input type="text" name="ddd_cel" id="ddd_cel" size="2" value="<?=set_value('ddd_cel')?>" />
<label for="celular">Celular - (Númerico):</label>
<input type="text" name="celular" id="celular" size="8" value="<?=set_value('celular')?>" />
<input type="submit" value="Salvar" id="salvar" />
</fieldset>
</form>
</body>
</html>

sucesso.php

<?// application/views/sucesso.php ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Exemplo de formulário de cadastro</title>
<meta name="description" content="Exemplo de formulário de cadastro." />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="language" content="pt-br" />
<meta name="author" content="Wellington Rocha" />
<style type='text/css'>
/*
Neste caso, foi adicionado a folha de estilo diretamente na página, mas
não é padrão desenvolver um projeto e adicionar o css desta forma.
*/
body { margin: 0; padding: 0; font-family: Lucida Grande, Verdana, Geneva, Sans-serif; font-size: 11px; color: #4F5155; }

form#cadastro { width: 400px;  margin: 0 auto;}

form#cadastro label, input { display: block; }

form#cadastro input{ margin-top: 10px; }

form#cadastro label{ margin-top: 5px; }
</style>
</head>
<body>
<div align="center">
<h3>Cadastro efetuado com sucesso.</h3>
<a href="<?=base_url()?>agenda">Voltar</a>
</div>
</body>
</html>

Formulário:

Validação

<?php
// application/config/form_validation.php
$config = array(
array(
'field' => 'nome',
'label' => 'Nome',
'rules' => 'required|min_length[2]'
),
array(
'field' => 'email',
'label' => 'Email',
'rules' => 'required|valid_email'
),
array(
'field' => 'ddd_tel',
'label' => 'DDD Telefone',
'rules' => 'required|integer|min_length[2]|max_length[2]'
),
array(
'field' => 'telefone',
'label' => 'Telefone',
'rules' => 'required|integer|min_length[8]|max_length[8]'
),
array(
'field' => 'ddd_cel',
'label' => 'DDD Celular',
'rules' => 'required|integer|min_length[2]|max_length[2]'
),
array(
'field' => 'celular',
'label' => 'Celular',
'rules' => 'required|integer|min_length[8]|max_length[8]'
)
);

Tradução das mensagens de erro

<?php

// Modificado por Wellington Rocha

$lang['required'] = "Campo %s é obrigatório.";
$lang['isset'] = "The %s field must have a value.";
$lang['valid_email'] = "Campo %s não tem um endereço de Email válido.";
$lang['valid_emails'] = "The %s field must contain all valid email addresses.";
$lang['valid_url'] = "The %s field must contain a valid URL.";
$lang['valid_ip'] = "The %s field must contain a valid IP.";
$lang['min_length']    = "%s deve ter no mínimo %s caracteres.";
$lang['max_length']    = "%s não pode exceder %s caracteres.";
$lang['exact_length'] = "The %s field must be exactly %s characters in length.";
$lang['alpha'] = "The %s field may only contain alphabetical characters.";
$lang['alpha_numeric'] = "The %s field may only contain alpha-numeric characters.";
$lang['alpha_dash'] = "The %s field may only contain alpha-numeric characters, underscores, and dashes.";
$lang['numeric'] = "The %s field must contain only numbers.";
$lang['is_numeric'] = "The %s field must contain only numeric characters.";
$lang['integer'] = "Campo %s deve ser preenchido com valores inteiros.";
$lang['matches'] = "The %s field does not match the %s field.";
$lang['is_natural'] = "The %s field must contain only positive numbers.";
$lang['is_natural_no_zero']    = "The %s field must contain a number greater than zero.";

/* End of file form_validation_lang.php */
/* Location: ./system/language/english/form_validation_lang.php */

Resultado do que foi feito:

Formulário // application/views/index.php

Validação dos dados

Todos os dados preenchidos, hora de salvar

Salvo as informações no banco de dados e renderizada a view: // application/views/sucesso.php

Conferindo banco de dados

Resultado ao tentar salvar o mesmo registro

Não me preocupei em escrever códigos para cada tipo de validação do formulário.

No controller existe somente código php.

Separo a lógica da aplicação das views.

Aumento minha produtividade, não me preocupo com alguns detalhes, consigo manter um padrão facilitando a manutenção de código, tenho url amigável, classe para sessão, paginação, upload de arquivos. Só faltou a Coca-Cola e o Big Mac, programar assim fica cada vez mais divertido.

Download do exemplo feito em CodeIgniter 1.7.1

Tags: CodeIgniter, desenvolvimento