O CodeIgniter é o melhor framework PHP da atualidade e, para corroborar esta informação, veremos que é possível trabalhar com diversos “ambientes” no CI. Mas o que, exatamente, isso significa?

O que são “ambientes” no CodeIgniter?

Em desenvolvimento de software – principalmente quando se trabalha com algum tipo de controle de versões – é bastante comum existirem diversos “ambientes“. Quando se desenvolve software (e sistemas e aplicações web estão aí inclusos), é desejável que determinadas configurações de seu ambiente de desenvolvimento sejam diferentes, dependendo de onde estão atualmente sendo executadas.

Por exemplo, quando se está programando, é desejável que a exibição de erros esteja habilitada. Afinal, este tipo de informação é útil para o(s) programador(es) e, como o site ainda não está “aberto ao público”, não há perigo em expor quaisquer configurações e/ou paths referentes ao projeto. Já para quando o site está “aberto”, é importante que este tipo de informação não seja exibida, já que exibe informações críticas relativas ao software e atrapalha a experiência do visitante/usuário – imagine erros de MySQL sendo exibidos para um pobre visitante que veio de uma SERP…

Geralmente existem 3 ambientes:

• desenvolvimento. Como sugere o próprio nome, é o ambiente usado pelos desenvolvedores para a produção e aprimoramento do software.
• homologação ou teste. Quando chegar o momento de testar o software (isso varia conforme o projeto, metodologia, equipe, etc), é neste ambiente em que isso é feito. O ambiente, além de estar disponível para “testadores oficiais” que fazem parte da equipe, também pode ser acessado por usuários escolhidos ou outras pessoas.
• produção. Acessado pelos visitantes e “usuários finais”. É quando já de desenvolveu/aprimorou o projeto (ou alguma parte específica dele), isso já foi passado (e aprovador) no ambiente de testes e, agora, está disponível para todas as pessoas.

Essas não são nomenclaturas “oficiais” e nem os ambientes precisam se restringir a 3, mas esse é o dia-a-dia da maioria dos projetos de desenvolvimento de software e funciona muito bem, obrigado! ;-)

E, como não poderia deixar de ser, uma das características do CodeIgniter é permitir que se lide com esses diferentes ambientes e suas respectivas configurações de forma bem fácil e simples!

Como configurar ambientes no CodeIgniter

A configuração de ambientes no CodeIgniter se dá, principalmente, no arquivo index.php. Nele, logo no início, há a definição da constante ENVIRONMENT. É aqui que se define qual ambiente será usado para a execução do CI.

Logo abaixo tem um switch. Ele simplesmente checa qual é o tipo de ambiente e, dependendo do resultado, aplica diferentes configurações.

E pode parecer incrível, mas é somente isso! Somente definindo qual ambiente será usado no momento (e que vai ser configurado segundo as configurações/diretrizes definidos no switch), já temos um controle de ambientes no CodeIgniter!

Exemplo de configuração de ambientes

Como se trata de um switch simples, é possível definir qualquer coisa que se queira para os diferentes ambientes. Voltemos ao exemplo da exibição de erros segundo o ambiente. Aproveitando, vamos suprimir o salvamento de queries ao BD quando não for necessário. Veja como é simples configurar o switch:

switch (ENVIRONMENT)
{
    case 'desenvolvimento':
        error_reporting(E_ALL);
	break;
 
    case 'teste':
    case 'producao':
	error_reporting(0);
        $this->db->save_queries = FALSE;
	break;
 
	default:
	exit('O ambiente da aplicação não está definido corretamente.');
}

Então, se o ambiente estiver configurado como “desenvolvimento”, os erros serão exibidos e as queries salvas.

define('ENVIRONMENT', 'desenvolvimento');

Caso esteja definido o ambiente de “teste” ou “producao”, os erros e salvamento de queries são suprimidos.

define('ENVIRONMENT', 'teste');

Ou seja, mudando 1 palavra em 1 linha de código é possível alternar entre os diferentes ambientes (lembrando que não precisando ser somente 3, seu switch pode ter quantos você quiser) e colher os benefícios de suas respectivas configurações.

Fluxo do software controlado pelo ambiente atual

Além de definir configurações que variam conforme o ambiente em que se esteja, também é possível definir o fluxo da aplicação e/ou executar funções específicas. Trata-se, tão somente, de uma constante que é definida, portanto, nada impede que, em algum controller, tenha-se um condicional do tipo:

if (ENVIRONMENT == 'desenvolvimento')
{
    // Código somente para o ambiente de desenvolvimento
}

Conclusão

Como vimos, lidar com diferentes ambientes em desenvolvimento de software usando CodeIgniter é tão difícil quanto alterar 1 linha de código… Configurando corretamente cada ambiente, é possível garantir maior segurança, desempenho e estabilidade ao projeto, já que é possível estabelecer diretivas específicas para cada um.

E você, tem alguma dica ou configuração que gostaria de recomendar para cada ambiente? Comente!

Por padrão, o CodeIgniter não suporta parâmetros $_GET; quando algo assim é identificado no URL, é automaticamente destruído pelo CI. Entretanto, pode haver situações em que é preciso pegar/passar variáveis com GET, seja por usar algum webservice, serviço de pagamento ou o que quer que seja.

Como o CodeIgniter é o melhor framework PHP, com ele também é possível liberar o acesso a parâmetros $_GET com muita facilidade. E mais: somente em controllers específicos!

Configurar o CodeIgniter para aceitar $_GET

A primeira coisa que deve ser feita é uma pequena alteração no arquivo /application/config/config.php. Localize a linha com a configuração “uri_protocol” e altere seu valor para “PATH_INFO“:

$config['uri_protocol'] =  'PATH_INFO';

Então, para cada método que seja preciso mexer com parâmetros GET, adicione o seguinte:

parse_str($_SERVER['QUERY_STRING'], $_GET);

A função parse_str do PHP simplesmente converte os parâmetros do URL em variáveis. Por exemplo:

$str = "framework=codeigniter&features[]=best+framework&features[]=rocks";
parse_str($str);
echo $framework;  // "codeigniter"
echo $features[0]; // "best framework"
echo $features[1]; // "rocks"

Obviamente a variável “str” do exemplo vai receber a URL-alvo (uma ajudinha sobre como pegar a URL atual) e, a partir daí, é possível trabalhar com variáveis comuns pra usar os parâmetros passados através de $_GET no CodeIgniter. Um exemplo de URL seria:

http://codeigniterbrasil.com/controller/metodo/?s=conteudo&c=codeigniter

Bem facinho, certo? Se alguém tiver alguma outra solução/dica sobre como usar GET no CodeIgniter e/ou pegar o URL atual, basta comentar!

O relacionamento padrão entre uma URL e um Controller no CodeIgniter segue a estrutura exemplo.com/classe/metodo/id/ (como mostrado no artigo sobre Controllers no CodeIgniter), mas, às vezes, é preciso “remapear” este relacionamento. No CodeIgniter, isso é feito através de routes (rotas).

Tomemos como exemplo a visualização de produtos em uma loja virtual. Digamos que a página para visualização dos detalhes de uma cadeira de balanço seja acessada através da URL minhaloja.com/produtos/detalhes/1/2 onde “produtos” é nosso controller; “detalhes” é a função que exibe os detalhes do produto; “1″ seja o código da categoria cadeiras; e “2″ seja o código de nossa cadeira de balanço. Esta estrutura funciona perfeitamente, mas, convenhamos, não é “elegante”.

Configuração de rotas

A configuração de rotas é feita através do arquivo /application/config/routes.php, na instalação padrão do CodeIgniter. Alguns exemplos de configuração de routes:

1
2
3
4
5
6

// "minhaloja.com/fale-conosco" vai direcionar para o controller "contato"
$route['fale-conosco'] = "contato";
 
// "minhaloja.com/fale-conosco" vai direcionar para o controller "cadastros"
// utilizando a função "novo_cliente"
$route['cadastro/clientes'] = "cadastros/novo_cliente";

Wildcards ou Curingas

Você pode usar curingas (wildcards) para configurar rotas. Desta forma, é possível deixar as URLs mais dinâmicas. Existem 2 tipos de wildcards:

1. :num. O wildcard “:num”, utilizado para rotear somente números.
2. :any. O curinga “:any”, utilizado para rotear qualquer caractere.

Voltando ao exemplo anterior, que tal transformar a URL “minhaloja.com/produtos/detalhes/1/2″ em “minhaloja.com/1/2/”? Seguindo a estrutura padrão do CodeIgniter, pressupõe-se que se está chamando o controller “1″ e, dentro do controller, a função “2″, o que não existe na prática.

Para resolver o problema, vamos escrever a seguinte rota:

1

$route[':num/:num'] = "produtos/detalhes";

Dessa forma, haverá direcionamento para “produtos/detalhes” sempre que os seguimentos 1 e 2 da URL sejam numéricos.

Exemplo da função detalhes dentro do controller “produtos”:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

class Produtos extends CI_Controller
{
    function __construct()
    {
        parent::__construct();	
    }
 
    function index()
    {
        // Função index é acessada quando não for passada nenhuma função para o controller
    }
 
    function detalhes()
    {
        echo $this->uri->segment(1); // retorna o código da categoria
        echo $this->uri->segment(2); // retorna o código do produto
    }
}

Rotas com expressões regulares

É possível utilizar expressões regulares para definir as rotas no CodeIgniter. Vamos reescrever a rota do nosso exemplo:

1

$route['(:num)/(:num)'] = "produtos/detalhes/$1/$2";

Agora, o controller fica assim:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

class Produtos extends CI_Controller
{
    function __construct()
    {
        parent::__construct();	
    }
 
    function index()
    {
        // Função index é acessada quando não for passada nenhuma função para o controller
    }
 
    function detalhes($id_categoria, $id_produto)
    {
        echo $id_categoria; // retorna o código da categoria
        echo $id_produto; // retorna o código do produto
    }
}

Rotas e SEO

A URL minhaloja.com/1/2/ ficou bem mais curta e elegante, mas não é amigável quando vamos falar de SEO. É muito melhor ter uma estrutura como:

http://minhaloja.com/cadeiras/cadeira-de-balanco/

Esta URL é “amigável” para os motores de busca e, se você tiver, por exemplo, um campo no cadastro de produtos da loja para armazenar o nome da categoria e uma “descrição de URL” (slug) do produto – como “cadeira-de-balanco” -, fica muito fácil. Essa técnica é comumente chamada de URLs amigáveis.

A regra do exemplo é:

1

$route['(:any)/(:any)'] = "produtos/detalhes/$1/$2";

O controller permanece inalterado; só é preciso buscar no banco de dados os produtos com base nos slugs de categoria e produto – caso não saiba como criar slugs, confira o artigo “URLs amigáveis (slug) à WordPress“, do blog desenvolvimento para web.

Rotas reservadas

Existem um wildcard reservado no CodeIgniter: “welcome”. Ou seja, você não poderá utilizar a seguinte rota em seus projetos:

1

$route['default_controller'] = 'welcome';

Conclusão

Rotas servem para alterar o relacionamento padrão entre uma URL e um Controller no CodeIgniter. Sabendo utilizar bem os tipos de rotas disponíveis, é possível criar estruturas incríveis, que realmente facilitam o desenvolvimento e acesso a controllers e funções – e o SEO agradece!

Com estas dicas já é possível configurar suas rotas e melhorar a navegação em seus projetos com CodeIgniter.

Espero que tenham gostado deste meu primeiro artigo no CodeIgniter Brasil e fiquem ligados para mais novidades!