Models no Codeigniter

Introduç�o aos models do Codeigniter

Neste artigo vamos falar sobre Models no CodeIgniter. O CodeIgniter � baseado no modo de desenvolvimento Model-View-Controller. A MVC � uma abordagem de software que realiza a separaç�o da l�gica da aplicaç�o de sua apresentaç�o. Na pr�tica, permite que nossas p�ginas web contenham o m�nimo de script, j� que a apresentaç�o � separada do PHP.

Observaç�o: Models est�o opcionalmente dispon�veis para se quisermos usar a abordagem MVC mais tradicional.

Model: Representa nossas estruturas de dados. Tipicamente, nossas classes model ir�o conter funç�es que nos ajudar�o a buscar, inserir e substituir informaç�es em nosso banco de dados.

No CodeIgniter models s�o classes PHP projetadas para trabalhar a informaç�o em nosso banco de dados. Por exemplo, suponhamos que vamos usar o CodeIgniter para gerenciarmos um portal. Poder�amos ter uma classe model contendo funç�es para inserir, atualizar e buscar nossos dados referentes ao portal no banco. Vejamos agora um exemplo de uma classe model.

Listagem 1: Exemplo de classe Model


class Portalmodel extends Model {
	var $title ='';
	var $content ='';
	var $Date ='';
	
	function Portalmodel()
	{
		// Chamar o construtor do Model
		parent::Model();	
	}
	function get_last_ten_entries()
	{
		$query=$this->db->get('entries',10);
		return $query->result();
	}
	function insert_entry()
	{
	$this->title =$_POST['title'];
	$this->contents =$_POST['content'];
	$this->date =time();
	$this->db->insert('entries',$this);
	}
	function update_entry ()
	{
	$this->Date =time();
	$this->db->update('entries',$this, array('id',$_POST[]));
	}
}

Relacionado: Curso de CodeIgniter

Estrutura do Model no Codeigniter

As classes model devem ser armazenadas no seguinte diret�rio: application/models/. Podemos tamb�m fazer o armazenamento em subpastas.

O prot�tipo b�sico de uma classe model �:

Listagem 2: Model prot�tipo b�sico


class Model_name extends Model {

	function Model_name()
	{
		// Chamar o construtor do Model
		parent::Model();	
	}
}

Onde temos �model_name�, colocamos o nome da nossa classe. Uma coisa muito importante que n�o podemos esquecer � que os nomes de classes devem ter a inicial sempre mai�scula e tamb�m devemos nos certificar de que nossa classe estende a classe model b�sica.

Quando fomos salvar esse model, o seu nome ser� o nome da classe, s� que todo em min�sculo. Por exemplo, se nossa classe �:

Listagem 3: Nome ao salvar a classe


class Artigos_model extends Model {

	function Artigos_model()
	{
		parent::Model();	
	}
}

Ent�o nesse caso nosso arquivo ficaria com o seguinte endereço no nosso diret�rio: Application/models/artigo_model.php.

Carregando um model no Codeigniter

Nossos models ser�o tipicamente carregados e chamados dentro das funç�es de nossos controllers. Para carregarmos um model, usaremos a seguinte funç�o: $this->load->model(�nome-do-model�);

Por�m, caso nosso model esteja em uma subpasta, temos que incluir o caminho relativo ao nosso diret�rio. Por exemplo, se tivermos um model localizado em application/models/portal/artigo_model.php. ir�amos carregar ele da seguinte forma: $this->load->model(�portal/nome-do-model�);

Uma vez que tenhamos carregado, vamos acessar as funç�es de nosso model utilizando um objeto como o mesmo classe que hav�amos criado:

$this->load->model(�nome-do-model�);

$this->nome-do-model->function();

Se desejarmos atribuir nosso model a um objeto de nome diferente, podemos especificar isto atrav�s do seguinte par�metro da funç�o de carregamento:

$this->load->model(�model-do-model�,�fubar�);

Vejamos um exemplo de um controller que carrega um model e ent�o serve uma view.

Listagem 4: Carregando um model e servindo a uma view


<?php
class Inicial extends CI_Controller {	
	
	function artigos()
	{
	$this->load->model('artigos_model')
	$data['query']=this->artigos_model->get_last_ten_entries();
	$this->load->view('viewprincipal',$data);
	}
}
?>

Conectando ao Banco de Dados

Quando carregamos um model, ele n�o se conecta automaticamente ao nosso banco, as seguinte opç�es de conex�o est�o dispon�veis:

Podemos conectar usando os m�todos padr�es de banco de dados, descritos aqui, atrav�s de nossa classe controller ou de sua classe model.

Podemos mandar a funç�o de carregamento do model para se autoconectar passando TRUE (booleano) atrav�s do terceiro par�metro, como definido no arquivo de configuraç�o de banco de dados: $this->load->model(�nome-do-model�,��,TRUE);

Podemos tamb�m passar as configuraç�es manualmente, tamb�m atrav�s do arquivo de configuraç�o de banco de dados. Encontrado no diret�rio application/config/database.php.

Listagem 5: Dados do arquivo application/config/database.php


$db['default']['hostname'] = 'localhost';
$db['default']['username'] = '';
$db['default']['password'] = '';
$db['default']['database'] = '';
$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';
$db['default']['swap_pre'] = '';
$db['default']['autoinit'] = TRUE;
$db['default']['stricton'] = FALSE;

Afinal, o que entender sobre os models no CodeIgniter

Este artigo teve como objetivo apresentar um pouco dos models no CodeIgniter, n�o sendo obrigat�ria sua utilizaç�o em nossas aplicaç�es web. Por�m, nos deixando a disposiç�o sua utilizaç�o, caso desejemos usar uma abordagem MVC completa. E tivemos a noç�o b�sica de como criarmos e carregarmos esses models. E por �ltimo vimos como modificar algumas configuraç�es da conex�o com o banco de dados.

Espero que tenha sido de f�cil compreens�o a todo os leitores. Fiquem a vontade para sugerir temas e dicas.

Abraços a todos e at� ao pr�ximo artigo.

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.
CodeIgniter: trabalhando com as Views do modelo MVC:
Veja neste artigo como funcionam as Views do modelo MVC no framework PHP CodeIgniter, entendendo como cri�-las e manipul�-las em suas aplicaç�es.

Utilizando models no CodeIgniter

Veja neste artigo como utilizar os models do modelo MVC no framework PHP CodeIgniter.