Instalando e Configurando o Contao CMS no Ambiente ServBay

Contao é um poderoso sistema de gerenciamento de conteúdo (CMS) open source, especialmente indicado para a criação de sites de pequenas e médias empresas, portais ou aplicações web complexas. Este guia detalha como instalar e configurar o Contao no ServBay, um ambiente local de desenvolvimento web prático para macOS, permitindo que você comece rapidamente o seu projeto com Contao.

O ServBay oferece um ambiente completo, integrando PHP, Composer, serviços de banco de dados (como MySQL/MariaDB, PostgreSQL) e servidores web (como Caddy, Nginx, Apache), o que simplifica totalmente a preparação do ambiente para o desenvolvimento local. Com o ServBay, você facilmente satisfaz os requisitos de execução do Contao.

O que é o Contao?

Contao é um CMS open source baseado em PHP, reconhecido por sua interface amigável, alta flexibilidade e um painel administrativo poderoso. Oferece recursos avançados como gerenciamento detalhado de permissões, controle de versões, suporte multilíngue, manipulação responsiva de imagens e uma arquitetura modular que favorece a extensão de funcionalidades. O principal objetivo do Contao é fornecer uma base sólida para desenvolvedores e designers criarem sites personalizados sem precisar começar do zero.

Pré-requisitos

Antes de começar a instalação do Contao, certifique-se de que possui os seguintes requisitos:

1. ServBay instalado e em execução: O ServBay deve estar instalado em seu macOS. Certifique-se de que está rodando, com a versão de PHP necessária (o Contao tem requisitos específicos; consulte a documentação oficial do Contao para os detalhes atualizados) e um serviço ativo de banco de dados (como MySQL ou MariaDB) habilitado.
2. Composer: O Composer já vem integrado ao ServBay — você não precisa instalar separadamente.
3. Acesso ao Terminal: Você precisará do terminal para executar comandos do Composer.

Etapas para Instalar o Contao

A seguir, você encontrará o passo a passo para instalar e configurar o Contao no ambiente ServBay.

Passo 1: Criar o diretório do projeto

Primeiro, navegue até o diretório raiz padrão do ServBay /Applications/ServBay/www, e crie um novo subdiretório para seu projeto Contao.

cd /Applications/ServBay/www
mkdir servbay-contao-app
cd servbay-contao-app

Instalaremos o Contao dentro do diretório servbay-contao-app.

Passo 2: Criar o projeto Contao usando Composer

A instalação e o gerenciamento do Contao são recomendados via Composer. Com o Composer já embutido no ServBay, você pode criar o projeto executando o comando abaixo no diretório do projeto:

composer create-project contao/managed-edition .

Este comando irá baixar a versão mais recente do Contao Managed Edition e todas as suas dependências para o diretório atual (.). O tempo deste processo pode variar de acordo com a velocidade da sua internet.

Sobre o Contao Managed Edition: contao/managed-edition é uma distribuição oficial que inclui o núcleo do Contao, as dependências recomendadas e uma estrutura padrão de projeto. Fique atento que ao instalar via managed-edition, o diretório web raiz do site será o subdiretório web dentro da pasta do projeto.

Passo 3: Criar banco de dados e usuário

O Contao precisa de um banco de dados para armazenar conteúdos e configurações. O ServBay oferece ferramentas como phpMyAdmin e Adminer para gerenciar bancos e usuários. Aqui, usaremos o phpMyAdmin como exemplo:

1. Acesse o phpMyAdmin fornecido pelo ServBay

   Abra o endereço local do ServBay: https://servbay.host/. Localize e acesse o link para o phpMyAdmin.

2. Crie um usuário do banco de dados

   Por questões de segurança, recomenda-se criar um usuário dedicado para o banco do Contao.

   a. Vá até a página de contas de usuário

   No painel principal do phpMyAdmin, clique em "Contas de Usuário" no menu superior.
   

   b. Adicione nova conta de usuário

   Clique em "Adicionar conta de usuário" e preencha os seguintes campos:
   
   *   **Nome do usuário:** Escolha um nome, por exemplo `contao_user`.
   *   **Servidor:** Selecione `localhost`. Assim, o acesso é restrito ao local, aumentando a segurança.
   *   **Senha:** Defina uma **senha forte**. Não use senhas simples como `senha123`; este campo é apenas exemplo. Use um gerador de senhas para o ambiente real.
   *   **Repetir:** Digite a senha novamente.
   
   Em "Banco de dados para usuário", normalmente selecione "Criar banco de dados com o mesmo nome e conceder todos os privilégios". Assim, um banco chamado `contao_user` será criado e todas as permissões dadas ao usuário recém-criado.
   
   *   Marque "Conceder todos os privilégios".
   *   Clique em "Executar" na parte inferior para finalizar a criação do banco e do usuário.
   

Passo 4: Configurar o site no ServBay

Agora, é hora de apontar um site no ServBay para o diretório do projeto Contao que você criou.

1. Abra o ServBay e adicione um novo site

   Abra o painel do ServBay. Na barra lateral, clique em "Sites". Clique em "Adicionar" para criar uma configuração de site.

2. Preencha as informações do site

   • Nome: Dê um nome fácil de identificar, como Meu Site Contao.
   • Domínio: Escolha um domínio local, sugerindo o uso de .local ou .servbay.demo, como servbay-contao.local. O ServBay irá resolver este domínio automaticamente.
   • Tipo de site: Selecione PHP.
   • Versão do PHP: Escolha uma versão compatível com os requisitos do Contao, de acordo com a documentação oficial.
   • Diretório raiz do site: Passo muito importante. Na instalação via Composer contao/managed-edition, os arquivos públicos do Contao (incluindo index.php) ficam no subdiretório web dentro do projeto. Portanto, indique o caminho completo para o diretório web: /Applications/ServBay/www/servbay-contao-app/web.

3. Salve a configuração

   Após preencher tudo, clique em "Salvar" no final da tela do ServBay. A nova configuração do site será aplicada.

Passo 5: Rodar o instalador web do Contao

Com o site configurado, já é possível acessar o instalador web do Contao pelo navegador.

1. Acesse a página de instalação

   No navegador de sua preferência, acesse o domínio configurado, acrescentando /contao/install. Por exemplo: https://servbay-contao.local/contao/install.

   Se tudo estiver correto, a página de instalação do Contao será exibida.

2. Preencha as informações do banco de dados

   O instalador solicitará informações de conexão. Preencha com os dados criados no passo 3:

   • Host do banco de dados: localhost
   • Nome do banco: contao_user (caso tenha criado com o mesmo nome do usuário, no phpMyAdmin)
   • Usuário: contao_user
   • Senha: A senha definida para `contao_user´.

3. Preencha os dados do administrador

   Conforme solicitado na tela, crie a conta de administrador do painel Contao: nome, senha, e-mail, etc. Use uma senha forte.

4. Conclua a instalação

   Prossiga com os passos indicados pelo instalador, geralmente incluindo a criação das tabelas no banco. Clique nos botões correspondentes ("Instalar", "Finalizar" ou similares) para completar o processo.

Passo 6: Verificar a instalação e acessar o painel administrativo

Depois de concluir a instalação, valide se o Contao está rodando e tente acessar o painel administrativo.

1. Acesse o site (frontend)

   No navegador, vá até o domínio, por exemplo https://servbay-contao.local/. Você deverá ver a página padrão de boas-vindas ou uma página em branco (dependendo da configuração padrão do Contao). Isso confirma que o servidor web está funcionando e o frontend do Contao está acessível.

2. Acesse o painel administrativo do Contao

   A página de login do painel geralmente fica em https://servbay-contao.local/contao.

   Entre com o nome de usuário e senha de administrador criados no Passo 5. Após o login, você terá acesso ao painel, podendo criar conteúdos, instalar extensões e configurar o site.

Perguntas Frequentes (FAQ)

P: Aparece erro ao acessar https://servbay-contao.local/ ou https://servbay-contao.local/contao/install. O quê fazer?

R:

• Verifique se o ServBay está em execução: Confirme que o ServBay está aberto, e os serviços necessários (PHP, Web Server – Caddy ou Nginx) estão ativos.
• Verifique a configuração do site no ServBay: Certifique-se de que todos os dados estão corretos, especialmente domínio, tipo de site, versão do PHP e principalmente o diretório raiz (deve ser o diretório web, na instalação via managed-edition).
• Verifique a resolução do domínio: O ServBay normalmente gerencia domínios .local automaticamente. Se usar outro sufixo ou tiver problemas, tente reiniciar o ServBay ou verifique seu arquivo hosts (embora normalmente o ServBay faça isso sozinho).
• Confira os logs do servidor web: Veja os logs do Caddy ou Nginx pelo painel do ServBay para mensagens de erro mais detalhadas.

P: Não consigo conectar ao banco de dados. O que devo fazer?

R:

• Verifique se o serviço de banco de dados está rodando: Confirme que o MySQL/MariaDB ou PostgreSQL estão ativos no ServBay.
• Confira suas credenciais: Revise cuidadosamente os dados digitados no instalador do Contao (host, banco, usuário, senha) e se estes coincidem com os criados no phpMyAdmin.
• Verifique as permissões do usuário: Certifique-se de que o usuário criado possui todas as permissões necessárias no banco para o Contao.

P: Surgiu um erro de permissões durante a instalação. O que devo fazer?

R: O instalador do Contao precisa acesso de escrita a certos diretórios. Apesar de a configuração padrão do ServBay geralmente ser suficiente, se surgir algum problema, ajuste manualmente as permissões no terminal:

cd /Applications/ServBay/www/servbay-contao-app
sudo chown -R seu_usuario:staff . # Substitua seu_usuario pelo seu nome de usuário no macOS
sudo chmod -R 755 .
sudo chmod -R 777 var/ cache/ system/config/ # O Contao pode precisar de escrita nestas pastas

Use o chmod 777 com cautela — não recomendado para produção, mas aceitável em desenvolvimento local em caso de problemas com permissões.

Conclusão

Seguindo este guia, você deverá conseguir instalar e configurar o Contao CMS com sucesso no ambiente local ServBay. O ambiente integrado do ServBay simplifica a gestão de dependências Composer, configuração de banco de dados e de servidor web, permitindo que você foque no desenvolvimento com o Contao. Agora, você pode usar o painel administrativo para criar conteúdos, desenhar páginas, instalar extensões e temas para construir seu site!

Se quiser se aprofundar no uso e nas funções do Contao, consulte a documentação oficial do Contao.