Controller no Codeigniter

O que � um Codeigniter Controller?

Neste artigo vamos falar sobre controllers do 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. Em pr�tica, permite que nossas p�ginas web contenham o m�nimo de script, j� que a apresentaç�o � separada do PHP.

Controller: Serve como um intermedi�rio entre o Model, a View, e qualquer outro recurso necess�rio para processar a requisiç�o HTTP e gerar a p�gina web.

Com o CodeIgniter temos uma abordagem mais solta em relaç�o ao MVC, j� que models n�o s�o obrigat�rios. Se n�o precisarmos desta facilidade, ou acharmos que manter models gerar� mais complexidade do que queremos ou precisamos, podemos ignor�-los e construir nossas aplicaç�es apenas usando Controllers e Views. O CodeIgniter tamb�m permite que possamos incorporar nossos pr�prios scripts, ou mesmo desenvolvermos bibliotecas para o sistema, nos possibilitando trabalhar de um modo que faça mais sentido para n�s.

Relacionado: Curso de CodeIgniter

Controllers no Codeginiter

No CodeIgniter os controllers s�o o coraç�o das nossas aplicaç�es, pois determinam como as requisiç�es HTTP devem ser trabalhadas.

O que � um controller?

Um controller � simplesmente um arquivo de classe que � nomeado de uma forma que possa ser associado a uma URL.

Vamos considerar a seguinte URL: http://localhost/post/index.php/inicial.

Neste exemplo, o CodeIgniter tentar� encontrar um controller chamado �inicial.php� e o carregar�

Quando um nome de um controller bater com o primeiro seguimento da URL, ele ser� carregado.

Testando o controller no codeigniter

Vamos agora criar um simples controller para que possamos v�-lo em aç�o. Crie um script chamado �inicial.php� e coloque nele o seguinte c�digo.

Listagem 1: Exemplo controller simples


<?php
	class Inicial extends CI_Controller
	{
		function index()
		{
			echo'Controller exemplo';
		}
	}
?>

Salve esse arquivo dentro da pasta �application/controllers/�.

Deve ser exibido o seguinte resultado no navegador.

Figura 1: Resultado Controller simples

� recomend�vel que o nome das classes controllers inicie com letra mai�scula, conforme o exemplo a seguir.

Listagem 2: Nome de classe da forma recomendada


<?php
	class Inicial extends CI_Controller
?>

E neste outro modo est� incorreta.

Listagem 3: Nome de classe da forma n�o recomendada


<?php
	class inicial extends CI_Controller
?>

E tamb�m sempre temos que ter certeza que nosso controlador estenda o controller pai, para que possa herdar todas as funç�es deste.

Funç�es do controller codeigniter

No exemplo anterior que criamos, o nome da funç�o � index(). A funç�o �index� � sempre carregada por default se o segundo segmento do URL estiver vazio. Outra maneira de mostrarmos nossa mensagem �Controller exemplo�, poderia ser esta: http://localhost/post/index.php/inicial/index.

A segunda parte do seguimento da URL determina qual funç�o no controller � chamada, vamos testar isso com o seguinte exemplo. Vamos adicionar a seguinte funç�o dentro do nosso controller.

Listagem 4: Adicionando funç�o comments no Controller

 
<?php
	class Inicial extends CI_Controller
	{
		function index()
		{
			echo'Controller exemplo';
		}
		function comments ()
		{
			echo'Mensagem alternativa';
		}
	}
?>

Agora carregue sua URL parecida com a seguinte para ver a funç�o comments:

http://localhost/post/index.php/inicial/comments.

Figura 2: Exemplo mensagem alternativa funç�o comments

Definindo o controller Default

Ao CodeIgniter podemos dizer para carregar o controller default quando n�o estiver expl�cito na URL, pois este ser� o caso quando apenas a URL raiz do nosso site � requisitada. Para especificarmos um controller default, vamos abrir o arquivo �application/config/routes.php� e alterarmos a seguinte vari�vel.

Listagem 5: Definindo controller Default


$route['default_controller'] = "Inicial";

Onde inicial � o nome da classe controller que queremos usar. Agora se carregarmos nosso index.php geral, sem especificarmos nenhum segmento na URL, veremos a mensagem �Controller Exemplo�: http://localhost/post/index.php/.

Figura 3: Index sem segmento

Remapeando a chamada funç�es

Como podemos notar acima, o segundo segmento da URL tipicamente indica qual funç�o no controller ser� chamada. O CodeIgniter n�s permite sobrepor este comportamento atrav�s do uso da funç�o _remap().

Importante: se nosso controller contiver uma funç�o chamada _remap(), ela sempre ser� chamada independente do que a nossa URL contenha. Ela sobrep�e o comportamento normal no qual a URL determina qual funç�o ser� chamada, nos permitindo definir nossas pr�prias regras de roteamento de funç�es.

A chamada de funç�o sobreposta (tipicamente o segmento do URL) ser� passada com um par�metro � funç�o _remap().

Listagem 6: Sintaxe da funç�o _remap()


<?php
class Inicial extends CI_Controller {		
  function _remap($method){
    // chama a funç�o gravar() somente se o m�todo
    // for "excluir"
    if($method == "excluir")
      $this->gravar();
    else
      $this->index();
  }
	
  function index(){
    echo "Est� � a p�gina principal";
  }
	
  function gravar(){
    echo "Sou a funç�o gravar";
  }
	
  function excluir(){
    echo "Sou a funç�o excluir";
  }
}
?>

Nesse exemplo, sempre que utilizarmos o seguimento da URL �excluir�, a funç�o chamada sempre ser� �gravar� : http://localhost/post/index.php/inicial/excluir.

Figura 4: Mapeando chamada de funç�o

Funç�es privadas

Em alguns casos, podemos querer que certas funç�es n�o sejam acessadas publicamente. Para criarmos uma funç�o privada, simplesmente adicionamos um underscore como prefixo do nome e ela n�o ser� servida via requisiç�o URL, por exemplo, se tivermos uma funç�o como a seguir.

Listagem 7: Funç�o privada


  function _utility()
  {
	echo "Testando funç�o privada";
  }

E se tentarmos acessa-la via requisiç�o URL dessa forma, n�o funcionar�:

http://localhost/post/index.php/inicial/_utility

Contrutores de classes

Se pretendermos utilizar um construtor em algum de nossos controlers, devemos colocar a seguinte linha de c�digo: Parent::Controller().

A raz�o para esta linha ser necess�ria � porque nosso construtor local ir� sobrepor aquele na classe controller pai, por isso a necessidade de chamarmos manualmente.

Se n�o estamos familiarizados com construtores no PHP4, um construtor � simplesmente uma funç�o que tem o mesmo nome da classe e que � executada para criar uma inst�ncia desta.

Listagem 8: Construtor de classe


<?php
class Inicial extends CI_Controller {	
	function Inicial ()
	{
	parrent::Controller();
	}
?>

Agora no PHP5 usamos a seguinte sintaxe.

Listagem 9: Construtor de classe PHP5

 

<?php
class Inicial extends CI_Controller {	
	function construct ()
	{
	parrent::Controller();
	}
}
?>

Construtores s�o muito �teis se desejamos definir alguns valores default ou executar um processo default enquanto uma classe � instanciada. Construtores n�o podem retornar um valor, mas podem executar algum trabalho default.

Organizando controllers codeigniter em subdiret�rios

Se estivermos criando uma aplicaç�o grande, podemos achar conveniente organizar os controllers em subdiret�rios. O CodeIgniter nos permite que façamos isso. Simplesmente temos que criar subdiret�rios em nosso diret�rio application/controllers e colocarmos nossos controllers dentro.

Observaç�o: ao utilizamos esse recurso, o primeiro segmento da nossa URL precisar� especificar o diret�rio. Por exemplo ,digamos que tenhamos um controller localizado assim: Apllication/controllers/artigos/ci.php.

Para conseguirmos chamar esse controller, nossa URL ficar� parecida com a seguinte: http://localhost/post/index.php/artigos/ci.

Cada um de nossos subdiret�rios poder� conter um controller default que ser� chamado se a URL contiver apenas um subdiret�rio. Simplesmente precisamos renomear nosso controller default no arquivo application/config/routes.php.

Nomes reservados de funç�es

J� que nossas classes controllers ir�o estender o controller principal da aplicaç�o, precisamos tomar cuidado em n�o nome�-las de forma id�ntica �quelas usadas pela principal, caso contr�rio, nossas funç�es locais ir�o sobrescrev�-las. Seguie abaixo uma lista de nomes reservados. N�o renomeie suas funç�es como uma destas:

Controller
CI_Base
_ci_initialize
_ci_scaffolding

E se caso estivermos rodando PHP4, ainda h� nomes adicionais. Estes se aplicam apenas se estivermos utilizando PHP4:

Ci_Loader
Config
Database
File
Helper
Helpers
Language
Library
Model
Plugin
Plugins
Scaffolding
Script
View
Vars
_ci_assign_to_models
_ci_autoloader
_ci_init_class
_ci_initscaffolding
_ci_is_instace
_ci_load
_ci_load_class
_ci_object_to_array

Assim concluimos mais este artigo, resumidamente � isso que necessitamos saber sobre controllers. Espero que o artigo tenha sido de f�cil compreens�o a todos.

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 ;)

Documentaç�o: PHP: While e Do While:
Este documento apresenta as estruturas de repetiç�o while e do while, recursos que possibilitam executar trechos de c�digo repetidamente com base em uma express�o booleana.
Como implementar o MVC em PHP:
O padr�o MVC � amplamente utilizado no desenvolvimento de aplicaç�es web, e saber implement�-lo � importante para trabalhar de forma eficiente com frameworks como CodeIgniter e Laravel, bem como para desenvolver projetos sem depender dessas soluç�es de terceiros.
Documentaç�o: PHP: Declaraç�o e atribuiç�o de vari�veis:
Neste documento voc� encontrar� o conte�do que precisa para aprender a declarar e utilizar vari�veis na linguagem PHP. � por meio das vari�veis que conseguimos guardar os dados em mem�ria e acess�-los quando necess�rio.

Trabalhando com controllers no CodeIgniter

Veja neste artigo como funcionam os controllers no framework PHP CodeIgniter, como criar seus controllers e funções.