Instalação do CakePHP: A instalação de um framework moderno como o CakePHP é um marco divisor de águas. Ao usar a CLI, você não está apenas “copiando arquivos”, você está orquestrando a criação de um ecossistema completo que inclui o núcleo do framework, as bibliotecas de segurança, o sistema de rotas e as ferramentas de console.
Neste artigo, vamos focar no uso do Composer para gerar o esqueleto da sua aplicação e entenderemos o que cada arquivo gerado faz ali.
1. Por que usar a CLI e o Composer?
Antigamente, instalar um site em PHP era sinônimo de baixar um .zip, extrair e torcer para que todas as bibliotecas estivessem lá. Com o CakePHP, o processo é padronizado globalmente.
Ao usar o comando composer create-project, você garante:
- Versão Correta: O Composer baixa a versão mais estável e compatível com seu PHP.
- Segurança: Todas as dependências são verificadas e instaladas em pastas protegidas.
- Prontidão: O framework já vem com uma chave de segurança gerada e permissões de pastas pré-configuradas.
2. O Comando de Instalação
Abra o seu terminal (ou CMD/PowerShell no Windows) e navegue até a pasta onde você costuma guardar seus projetos (ex: cd ~/Projetos ou cd C:\xampp\htdocs).
Execute o seguinte comando para criar um projeto chamado meu_app:
Bash
composer create-project --prefer-dist cakephp/app:^5.0 meu_app
Nota do Especialista: O parâmetro
^5.0garante que você está instalando a versão mais recente do CakePHP 5. Se o seu ambiente ainda estiver no PHP 7.4, você precisaria usar^4.0, mas como configuramos o PHP 8 no artigo anterior, vá de versão 5 sem medo!
O que acontece durante a instalação?
- O Composer lê o “esqueleto” oficial do CakePHP.
- Ele baixa o
cakephp/cakephp(o núcleo) e todas as suas dependências (como bibliotecas de log, banco de dados e manipulação de strings). - Ele executa um script de “pós-instalação” que cria o arquivo de configuração
app_local.phpe gera uma Security.salt única para o seu projeto.
3. Explorando a Estrutura de Pastas (O Mapa do Tesouro)
Após o término da instalação, entre na pasta: cd meu_app. Você verá uma estrutura que, à primeira vista, parece complexa, mas é extremamente lógica. Vamos dissecar as pastas principais que você usará 99% do tempo:
A pasta bin/
Aqui reside o executável do Cake. É através dele que rodamos o “Bake” (gerador de código) e executamos comandos de manutenção via terminal.
- Comando útil:
bin/cake --version
A pasta config/
Toda a inteligência de configuração do app está aqui.
app.php: Configurações gerais (e-mail, cache, segurança).app_local.php: CRÍTICO. É aqui que você coloca suas credenciais de banco de dados. Este arquivo nunca deve ir para o seu GitHub/GitLab, pois contém senhas.routes.php: Onde você define as URLs amigáveis do seu site.
A pasta src/ (Onde a mágica acontece)
É aqui que você passará a maior parte do seu dia. Ela contém o seu código MVC:
Controller/: Seus maestros.Model/: Suas tabelas e entidades.Template/: Seus arquivos de visualização (HTML + PHP).Middleware/: Camadas de filtro para as requisições.
A pasta webroot/
Esta é a única pasta que deve ser “pública”. Nela ficam seus arquivos de imagem, CSS, JavaScript e o arquivo index.php que inicia o framework.
4. O Servidor Embutido: Testando a Instalação
Você não precisa configurar um Apache ou Nginx complexo apenas para começar a programar. O CakePHP vem com um servidor de desenvolvimento embutido.
No terminal, dentro da pasta do projeto, digite:
Bash
bin/cake server
Agora, abra seu navegador e acesse: http://localhost:8765.
Se tudo estiver correto, você verá a famosa página colorida do CakePHP com vários checkmarks verdes. Se algum estiver vermelho (geralmente o de banco de dados), não se preocupe, resolveremos isso no artigo sobre conexão com DB.
5. Primeiros Passos de Configuração
Mesmo com a instalação pronta, um bom desenvolvedor faz dois ajustes rápidos para garantir que o projeto está “saudável”.
Verificando a Security Salt
Abra o arquivo config/app_local.php e procure por 'Security'. Você verá um código alfanumérico longo. O CakePHP gera isso automaticamente, mas é bom saber que essa chave é usada para criptografar cookies e senhas. Nunca a compartilhe.
Definindo o Timezone e Locale
No arquivo config/app.php, procure por 'App'. Ajuste para o nosso padrão brasileiro se necessário:
PHP
'defaultLocale' => env('APP_DEFAULT_LOCALE', 'pt_BR'),
'defaultTimezone' => env('APP_DEFAULT_TIMEZONE', 'America/Sao_Paulo'),
6. Resolvendo Problemas Comuns na Instalação CLI
Erro: “Composer is not recognized”
- Causa: O Composer não está no seu PATH do sistema.
- Solução: Reinicie o terminal ou reinstale o Composer marcando a opção de adicionar às variáveis de ambiente.
Erro: “mbstring or intl extension is missing”
- Causa: Seu PHP não tem as extensões que discutimos no artigo 2.
- Solução: Edite seu
php.ini, remova o;da frente deextension=intleextension=mbstringe reinicie o terminal.
Conclusão: Seu Forno está Pré-aquecido!
Instalação do CakePHP: Instalar o CakePHP via CLI é o primeiro passo para uma carreira profissional. Você agora possui uma estrutura robusta, organizada sob os padrões da PSR-12 e pronta para escala.
Diferente de começar um projeto do zero absoluto, onde você perderia dias criando sistemas de rotas e segurança, aqui você já começa com tudo isso resolvido. O “bolo” já tem a massa pronta; agora vamos começar a recheá-lo.
Mas antes de dominar o CakePHP, se for o seu caso, toda jornada tem um início. Vamos entender quais são os conhecimentos básicos necessários para aproveitar ao máximo este poderoso framework. Para iniciar seus estudos no CakePHP, você precisará dominar as seguintes tecnologias:
E se você gosta do nosso conteúdo, não deixe de contribuir adquirindo os serviços e produtos dos nossos apoiadores e empresas que somos associados.
Instalação do CakePHP: E por fim e não menos importante, compartilhe nossos artigos com aquele amigo iniciante ou aquele que já trabalha na área e precisa de um material de apoio completinho!
