Introdução ao CakePHP: instalação e configuração do framework

Abril de 2006

Pra quem nunca ouviu falar do CakePHP, segue uma tradução da descrição presente no site oficial:

"CakePHP é um framework para o desenvolvimento rápido de aplicações em PHP que utiliza design patterns bastante conhecidos, como ActiveRecord, Association Data Mapping, Front Controller e MVC (Model-View-Controller). O objetivo principal é fornecer um framework estruturado que possibilite aos programadores de PHP de todos os níveis desenvolverem aplicações robustas rapidamente, sem perder flexibilidade."

Você não precisa saber tudo sobre os padrões de design utilizados nem conhecer cada linha de código do framework, mas é importante ter uma noção de como ele trabalha internamente antes de começar a escrever código.

Instalação e configuração

Para instalar o Cake você precisa de um servidor HTTP com suporte a sessions e mod_rewrite (esse último não é estritamente necessário, mas é recomendável para tornar as urls mais amigáveis), uma versão do PHP posterior a 4.3.2 (podendo ser versão 5) e um banco de dados (de preferência MySQL, mas de acordo com o site há suporte para PostgreSQL e ADODB. Se puder escolher, use o MySQL pois é mais fácil obter suporte).

O manual oficial do Cake descreve dois modos de instalação: o modo de desenvolvimento e o de produção. A única diferença entre eles é que no modo de desenvolvimento você vai acessar sua aplicação através de uma URL como http://www.seusite.com/cake/alguma-coisa e no modo de produção fica somente http://www.seusite.com/alguma-coisa. Eles dizem que o modo de desenvolvimento não é seguro, mas não explicam porque e eu confesso que ainda não descobri. Tem um tópico na lista oficial dando a entender que usando o modo de desenvolvimento os usuários poderiam acessar os arquivos internos do Cake diretamente, mas pelo menos nos meus testes isso não foi possível. Enfim, se você estiver apenas testando o framework num servidor local, isso não é muito importante.

Os passos para instalação são:

  1. Acessar o site oficial do framework e baixar a última versão;
  2. Descompactar o arquivo numa pasta do seu servidor web;

  3. Se estiver usando o Apache, habilite o mod_rewrite editando o arquivo httpd.conf (basta descomentar as linhas que contém as diretivas LoadModule e AddModule referentes ao mod_rewrite). Verifique também se a diretiva AllowOverride está setada para All no diretório em que você instalar o Cake. Essa diretiva determina se os arquivos .htaccess podem alterar as configurações do servidor em um determinado diretório. Essa diretiva deve estar dentro de um bloco <Directory> no httpd.conf. Por exemplo, se no httpd.conf estiver escrito:

    <Directory "C:/wwwroot">
            AllowOverride All
<Directory>

    Isso significa que no diretório C:/wwwroot o arquivo .htaccess poderá alterar qualquer configuração. O contrário seria setar o AllowOverride para "None". Para poder usar as urls amigáveis do CakePHP, você deve setar o AllowOverride para All. Se você não sabe muito bem onde adicionar essa diretiva, procure pelo comentário "This should be changed to whatever you set DocumentRoot to." no httpd.conf e adicione "AllowOverride All" na seção Directory logo abaixo do tal comentário.

  4. No seu navegador, acesse http://site.com/dir/, substituindo "site.com" pelo endereço do seu servidor e "dir" pelo diretório em que você descompactou os arquivos do Cake.

Se tudo correu bem, você verá uma mensagem informando sobre o status da conexão com o banco de dados (normalmente "Your database configuration file is not present."). Caso você tenha resultados inesperados, pense no problema e veja o que pode estar errado. Se não conseguir resolver, peça ajuda no grupo oficial (em inglês) ou no grupo em português que um cidadão de Portugal criou. Muita dúvida já foi respondida, então sempre é bom procurar nos arquivos antes de enviar uma mensagem.