Instalando e Configurando o Drupal no Ambiente Local ServBay

Visão Geral

O Drupal é um sistema de gerenciamento de conteúdo (CMS) open source poderoso, flexível e escalável, amplamente utilizado para criar desde blogs pessoais e sites de pequenas empresas até portais corporativos de grande porte e aplicações web complexas. Ele oferece ferramentas avançadas de gestão de conteúdo, controle refinado de permissões de usuários e uma arquitetura modular robusta, ideal para desenvolvedores que precisam de alta personalização e desempenho.

O ServBay é uma ferramenta de ambiente de desenvolvimento web local criada especialmente para macOS, integrando servidores web populares (como Caddy e Nginx), múltiplos runtimes de linguagens (PHP, Node.js, Python, Go, Java, etc.), bancos de dados (MySQL, PostgreSQL, MongoDB, Redis) e ferramentas para desenvolvedores como Composer e npm. Instalar e configurar o Drupal no ServBay lhe proporciona uma plataforma de desenvolvimento local estável, conveniente e completa.

Neste artigo, você aprenderá em detalhes como instalar e configurar o Drupal no ServBay, facilitando a montagem do seu ambiente de desenvolvimento Drupal local.

Pré-requisitos

Antes de iniciar a instalação do Drupal, verifique se você atende aos seguintes requisitos:

1. ServBay instalado e em execução: Certifique-se de que o ServBay já está instalado com sucesso no seu macOS e está rodando normalmente.
2. Conhecimento básico de uso do ServBay: Saiba como gerenciar pacotes, adicionar sites e acessar ferramentas integradas (como o phpMyAdmin) via interface do ServBay.
3. PHP e MySQL/MariaDB instalados: O ServBay já inclui várias versões do PHP e do MySQL ou MariaDB por padrão. Garanta que a versão do PHP desejada está ativada e que o serviço de banco de dados está rodando.
4. Composer instalado: O Composer vem integrado ao ServBay e será utilizado neste guia para criar o projeto Drupal.

Passos para Instalação do Drupal

Siga os passos abaixo para instalar e configurar o Drupal no ambiente ServBay:

Passo 1: Criar o Diretório do Projeto

Primeiro, crie um subdiretório específico para seu projeto Drupal dentro do diretório raiz dos sites do ServBay em /Applications/ServBay/www.

Abra o aplicativo Terminal e execute:

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

Isso criará uma nova pasta chamada servbay-drupal-app dentro de /Applications/ServBay/www e navegará para ela.

Passo 2: Criar o Projeto Drupal com Composer

O ServBay já inclui o Composer, não sendo necessário instalar manualmente. A recomendação oficial do Drupal é criar e gerenciar projetos via Composer.

No diretório servbay-drupal-app criado anteriormente, rode o comando:

composer create-project drupal/recommended-project .

Este comando utilizará o template drupal/recommended-project para criar um novo projeto Drupal no diretório atual (.). O Composer vai baixar automaticamente o núcleo do Drupal e suas dependências. O tempo desse processo pode variar dependendo da sua internet.

O template drupal/recommended-project organiza todos os arquivos públicos (como index.php, CSS, arquivos JavaScript, etc.) dentro de um subdiretório chamado web, estrutura padrão em projetos modernos Drupal, que traz mais segurança.

Passo 3: Criar Banco de Dados e Usuário

O Drupal precisa de um banco de dados para armazenar conteúdos, configurações e dados de usuários. Usaremos o phpMyAdmin integrado do ServBay para criar o banco e o usuário correspondente.

1. Acesse o phpMyAdmin do ServBay

   Abra o navegador e vá até o dashboard padrão do ServBay: https://servbay.host/. No painel, localize e clique em “phpMyAdmin” (normalmente em “Ferramentas” ou “Banco de Dados”) para abrir a interface do phpMyAdmin.

   servbay.host é um domínio especial criado pelo ServBay para facilitar o gerenciamento local.

2. Criar usuário do banco de dados

   É recomendável criar um usuário dedicado ao seu projeto Drupal por segurança.

   • Acesse “Contas de usuários”: No topo do phpMyAdmin, clique em “Contas de usuários”.
   • Adicionar nova conta: Clique em “Adicionar conta de usuário”.
   • Preencha os dados:
     • Nome de usuário: Escolha um nome, por exemplo, drupal_user.
     • Nome do host: Selecione ou digite localhost (restringe o acesso ao próprio computador).
     • Senha: Defina uma senha segura (não use exemplares fracos como password123 — gere uma senha forte real em projetos).
     • Repetir senha: Insira novamente a senha.
   • Permissões de banco: Na seção “Criar banco de dados para o usuário”, marque “Criar um banco de dados com o mesmo nome e conceder todos os privilégios”.
   • Permissões globais: Não marque privilégios globais “Conceder todos os privilégios” (a menos que você tenha um motivo específico).
   • Executar: Revise os dados e clique em “Executar” no canto inferior direito.

   Pronto! Agora você tem um banco e usuário drupal_user com todas as permissões para aquele banco.

Passo 4: Configurar o Servidor Web (Adicionar Site no ServBay)

Agora, é hora de configurar um site no ServBay, apontando um domínio local para o diretório web do seu projeto Drupal.

1. Abra a UI do ServBay: Execute o aplicativo ServBay.
2. Adicionar novo site: No menu à esquerda, clique em “Sites”.
3. Clique no botão de adição: Na lista de sites, clique em “+” ou opção equivalente para criar a configuração.
4. Preencha os dados do site:
   • Nome: Coloque um nome fácil de lembrar, como Meu Site Drupal.
   • Domínio: Escolha o domínio local, como servbay-drupal.local. O ServBay permite domínios .local sem exigir alteração do arquivo hosts do sistema.
   • Tipo de site: Selecione PHP.
   • Versão do PHP: Escolha a versão desejada de acordo com o Drupal que será instalado (consulte a documentação oficial do Drupal sobre requisitos).
   • Diretório raiz: Este ponto é crucial! O diretório raiz deve apontar para web, onde está o arquivo index.php criado pelo Composer, ou seja: /Applications/ServBay/www/servbay-drupal-app/web.
5. Salvar configuração: Após preencher tudo, clique em “Salvar” ou equivalente. O ServBay atualizará a configuração do servidor web automaticamente.

Passo 5: Executar o Instalador do Drupal

Agora, você pode acessar o instalador web do Drupal via navegador usando o domínio que configurou.

1. Acesse o instalador

   No navegador, acesse o domínio local com /core/install.php: https://servbay-drupal.local/core/install.php.

   Você verá o assistente de instalação do Drupal.

2. Selecione o idioma

   Escolha o idioma padrão desejado para o site Drupal e clique em “Salvar e continuar”.

3. Escolha o tipo de instalação

   Selecione o perfil de instalação, normalmente “Padrão” para um site com recursos mais comuns. Clique em “Salvar e continuar”.

4. Configure o banco de dados

   O instalador pedirá informações do banco criado no Passo 3:

   • Tipo de banco: Selecione MySQL, MariaDB, Percona Server, ou equivalente.
   • Nome do banco: drupal_user (igual ao criado).
   • Nome de usuário: drupal_user (igual ao criado).
   • Senha: Senha definida para drupal_user.
   • Host do banco: localhost.
   • Configurações avançadas: Mantenha o padrão, a menos que tenha alguma configuração especial.

   Clique em “Salvar e continuar”. O Drupal conectará ao banco e iniciará a importação de dados.

5. Preencha as informações do site

   Com o banco conectado, configure o site:

   • Nome do site: Título do seu site.
   • E-mail do site: Usado para notificações do sistema.
   • Usuário administrador: Nome de acesso ao painel Drupal.
   • Senha do administrador: Defina uma senha segura para o administrador.
   • País: Selecione seu país.
   • Fuso horário: Defina o fuso horário.

   Finalize clicando em “Salvar e continuar”. O Drupal concluirá a instalação e criará os arquivos necessários.

6. Finalização da instalação

   Ao terminar, você será redirecionado para a página inicial do novo site Drupal. Pronto, seu Drupal está instalado com sucesso no ServBay!

Passo 6: Instalando Módulos e Temas (Noções Iniciais)

O grande diferencial do Drupal está em seu ecossistema de módulos e temas, que expandem as funcionalidades do site.

1. Acesse o painel do administrador Drupal: Visite https://servbay-drupal.local/user ou https://servbay-drupal.local/admin e faça login com os dados do passo anterior.
2. Instale módulos: No painel, navegue em “Extensões” (Extend), veja, pesquise e ative novos módulos para adicionar funcionalidades.
3. Instale temas: Acesse “Aparência” (Appearance), instale e ative novos temas para alterar o visual do site.

Pós-instalação: Configuração e Uso Inicial

Com o Drupal instalado, você pode começar a construir seu site. Veja alguns passos iniciais recomendados:

Criar Tipos de Conteúdo e Publicar Conteúdo

No Drupal, “tipos de conteúdo” definem as estruturas (como artigos, páginas etc).

1. Crie um tipo de conteúdo: No painel Drupal, vá em “Estrutura” -> “Tipos de conteúdo”. Edite tipos existentes ou clique em “Adicionar tipo de conteúdo”, definindo os campos necessários.
2. Crie conteúdo: Acesse “Conteúdo” -> “Adicionar conteúdo”, escolha o tipo, preencha os campos e clique em “Salvar e publicar”.

Configurar Menus de Navegação

Os menus organizam os links do seu site.

1. Crie menus: No painel, navegue em “Estrutura” -> “Menus”. Adicione novos menus ou edite existentes.
2. Adicione itens: Edite um menu, clique em “Adicionar link”, preencha o texto e caminho de destino (interno como /node/1 ou URL externa) e salve.

Personalizar o Layout de Blocos

Blocos são unidades de conteúdos personalizáveis exibidas em áreas específicas do site (exemplo: barras laterais, rodapé).

1. Adicione blocos: Acesse “Estrutura” -> “Layout dos blocos”. Veja as regiões do tema e arraste blocos disponíveis para diferentes áreas.
2. Configure blocos: Clique em “Configurar” ao lado do bloco para definir título, páginas de exibição, visibilidade por papel de usuário, entre outros.

Dicas e Perguntas Frequentes (FAQ)

• Como alterar configurações do PHP? Se precisar de extensões específicas ou aumentar limites como memory_limit para o Drupal, acesse “Pacotes” na UI do ServBay, encontre a versão desejada de PHP, e edite o arquivo php.ini. Reinicie o serviço PHP após alterar.
• Meu site não está carregando, o que pode ser?
  • Verifique se o ServBay está rodando.
  • Confirme se as configurações do site no ServBay estão corretas, principalmente domínio e diretório raiz (.../servbay-drupal-app/web).
  • Certifique-se de que o servidor web (Caddy ou Nginx) do ServBay está ativo.
  • Confira se acessou https://servbay-drupal.local com o caminho correto.
• Erro de conexão ao banco de dados?
  • Revise se nome, usuário e senha do banco coincidem com o criado no phpMyAdmin.
  • O host do banco deve ser localhost.
  • O serviço MySQL/MariaDB precisa estar rodando no ServBay.
• Problemas ao instalar dependências com Composer? Verifique sua conexão com a internet. O Composer precisa acessar o packagist.org. Se necessário, limpe o cache ou atualize o Composer via ServBay.
• Problemas de permissão de arquivos? O Drupal precisa de escrita em certos diretórios (como web/sites/default/files e web/sites/default/settings.php). O ServBay normalmente executa serviços como o usuário corrente, evitando esses problemas, mas caso ocorram, corrija as permissões destes diretórios.

Resumo

Seguindo este guia, você configurou com sucesso o Drupal no seu ambiente de desenvolvimento local ServBay. O ServBay oferece uma solução eficiente, prática e integrada para o desenvolvimento Drupal, pronta para uso com todos os componentes necessários. Agora você pode aproveitar ao máximo o potencial do Drupal para construir, testar e depurar seu site localmente. Com a flexibilidade do ServBay, gerenciar múltiplas versões de PHP, bancos de dados e outros serviços se torna simples, proporcionando a liberdade necessária para diferentes projetos.