Instalando e Configurando o ExpressionEngine CMS no Ambiente Local ServBay

Visão Geral

O ExpressionEngine é um poderoso e flexível sistema de gerenciamento de conteúdo (CMS), amplamente utilizado para criar diversos tipos de sites e aplicações web complexas. Ele oferece uma variedade de recursos centrais e uma arquitetura altamente modular, permitindo que desenvolvedores e designers criem e personalizem sites com liberdade.

O ServBay é um ambiente de desenvolvimento web local projetado especificamente para macOS, oferecendo uma solução completa e integrada. Ele inclui diversos servidores web populares (como Nginx, Caddy, Apache), runtimes de linguagens de programação (PHP, Node.js, Python, Go, Java, Ruby, Rust, .NET), bancos de dados (MySQL, PostgreSQL, MongoDB, Redis) e ferramentas para desenvolvedores (Composer, npm/yarn, phpMyAdmin/Adminer). Com o ServBay, desenvolvedores podem configurar e gerenciar facilmente ambientes locais de desenvolvimento.

Neste artigo, você encontrará um passo a passo detalhado sobre como instalar e configurar o ExpressionEngine no ServBay, facilitando o início do seu projeto com o ExpressionEngine.

Por que Escolher o ServBay para Instalar o ExpressionEngine?

Instalar o ExpressionEngine localmente usando o ServBay traz diversas vantagens:

• Ambiente Integrado: O ServBay já inclui o runtime PHP, banco de dados MySQL e servidor web necessários para o ExpressionEngine, eliminando a necessidade de instalações e configurações separadas.
• Suporte a Múltiplas Versões: É possível alternar e selecionar diferentes versões do PHP facilmente, conforme as exigências do ExpressionEngine.
• Gerenciamento Facilitado de Bancos de Dados: O ServBay possui phpMyAdmin ou Adminer integrados, tornando fácil criar e gerenciar o banco de dados requerido pelo ExpressionEngine.
• Configuração Simples de Sites: Com a interface gráfica do ServBay, você pode configurar rapidamente um site local apontando para o diretório do seu projeto ExpressionEngine.
• Isolamento e Gestão de Projetos: O ServBay permite criar configurações de site independentes para cada projeto, evitando conflitos entre ambientes.

Pré-Requisitos

Antes de começar a instalação, certifique-se de atender aos seguintes requisitos:

1. O ServBay já está instalado e rodando em seu macOS. Caso ainda não tenha instalado, acesse o site oficial do ServBay para ver o guia de instalação.
2. Conhecimento básico sobre como usar o terminal/linha de comando.
3. Noções básicas de bancos de dados (como o conceito de banco de dados e usuários).
4. Permissões de escrita na pasta padrão de sites do ServBay: /Applications/ServBay/www.

Passos para Instalação

Vamos seguir as etapas abaixo para instalar e configurar o ExpressionEngine no ambiente ServBay.

Passo 1: Preparar o Diretório do Projeto e Baixar o ExpressionEngine

Primeiro, abra o seu terminal. Navegue até o diretório raiz de sites do ServBay /Applications/ServBay/www, crie uma nova pasta para o projeto (exemplo: servbay-ee-app) e acesse o diretório criado.

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

Em seguida, use o comando curl para baixar a versão mais recente do ExpressionEngine para o diretório atual. O parâmetro -L segue redirecionamentos e -o define o nome do arquivo de saída.

curl -L https://expressionengine.com/latest -o expressionengine.zip

Passo 2: Descompactar os Arquivos do ExpressionEngine

Após o download, utilize o comando unzip para extrair o arquivo expressionengine.zip dentro de servbay-ee-app. Depois disso, o arquivo zip pode ser removido.

unzip expressionengine.zip
rm expressionengine.zip

Os arquivos do ExpressionEngine estarão agora na estrutura da pasta servbay-ee-app.

Passo 3: Criar o Banco de Dados e Usuário para ExpressionEngine

O ExpressionEngine necessita de um banco de dados para armazenar conteúdo e configurações. O ServBay conta com MySQL e phpMyAdmin integrados para facilitar a gestão.

1. Acesse o phpMyAdmin do ServBay

   Abra o navegador e acesse o portal de ferramentas locais do ServBay em: https://servbay.host/. Encontre e clique no link “phpMyAdmin”, que abrirá a tela de login do phpMyAdmin. Use o usuário e senha padrão do banco de dados do ServBay (geralmente não há senha para acessar localhost em instalações padrão; consulte as configurações do ServBay).

2. Crie um Usuário e Banco de Dados

   Após entrar no phpMyAdmin, crie um usuário e um banco de dados exclusivos para o ExpressionEngine.

   • Acesse a página de Contas de Usuários: No topo da tela principal do phpMyAdmin, clique em “Contas de Usuários”.
   • Adicione um novo usuário: Selecione “Adicionar Conta de Usuário”.
   • Preencha os dados do usuário e banco de dados:
     • Nome do Usuário: Escolha um para a conexão do ExpressionEngine com o banco, por exemplo, ee_user.
     • Host: Selecione localhost. Isso restringe o acesso do usuário ao banco apenas localmente, aumentando a segurança.
     • Senha: Defina uma senha segura para o usuário do banco de dados. Guarde essa senha. Para exemplo, pode ser password123, mas em produção use sempre uma senha forte.
     • Confirmação da Senha: Digite novamente a senha.
     • Criar Banco de Dados para o Usuário: Marque a opção para criar um banco de dados com o mesmo nome do usuário e conceder todas as permissões. Isso criará, por exemplo, o banco ee_user e dará permissão total ao usuário criado.
   • Confirme as permissões: Certifique-se de que na seção “Permissões Globais” não estão marcadas opções desnecessárias (já que criamos o banco com as permissões adequadas).
   • Execute: Clique em “Executar” no fim da página para finalizar a criação do usuário e banco.

   Agora, você tem um banco chamado ee_user e um usuário ee_user com acesso total a ele.

Passo 4: Configurando o Site no ServBay

Vamos agora dizer ao ServBay como direcionar um domínio específico (como servbay-ee.local) para a pasta do projeto ExpressionEngine.

1. Abra o ServBay e adicione um novo site

   Abra a interface gráfica do ServBay. No menu à esquerda, clique em “Sites”. Então clique no botão “+” ou “Adicionar” para criar uma nova configuração de site.

   • Nome (Name): Dê um nome fácil de identificar para a configuração, como Meu Site ExpressionEngine.
   • Domínio (Domain): Defina o domínio que usará para acessar o site localmente, ex: servbay-ee.local. O ServBay cuida automaticamente do registro deste domínio em seu arquivo hosts, apontando para o localhost (127.0.0.1).
   • Tipo do Site (Type): Selecione PHP, pois o ExpressionEngine é feito em PHP.
   • Versão do PHP (PHP Version): Escolha a versão compatível com o ExpressionEngine baixado. O ServBay oferece múltiplas versões PHP para você selecionar.
   • Diretório Raiz (Document Root): Clique em “Procurar” e selecione a pasta do projeto criada no passo 1: /Applications/ServBay/www/servbay-ee-app.
   • Servidor Web (Web Server): Escolha entre os servidores disponíveis (Nginx, Caddy, Apache). O ServBay gera automaticamente a configuração adequada. Para desenvolvimento local, a opção padrão geralmente é suficiente.

2. Salve e aplique a configuração

   Após preencher, clique em “Salvar” ou “Aplicar”. Pode ser que seja necessário reiniciar o servidor web do ServBay para aplicar as mudanças. Siga as instruções na tela e aguarde o reinício.

   Agora, ao acessar https://servbay-ee.local/ no navegador, o ServBay irá encaminhar as requisições ao diretório do projeto ExpressionEngine.

Passo 5: Execute o Instalador Web do ExpressionEngine

O ExpressionEngine oferece um instalador via navegador que orienta no ajuste final do sistema.

1. Acesse a Página de Instalação

   No navegador, vá até o domínio configurado no ServBay, adicionando o instalador do ExpressionEngine, admin.php. Por padrão, ele está na raiz do projeto.

   URL: https://servbay-ee.local/admin.php

   Você deve ver a página de boas-vindas ou o assistente de instalação do ExpressionEngine.

2. Configure pelo Assistente

   O instalador pedirá as seguintes informações essenciais:

   • Dados de Conexão com o Banco de Dados:
     • Host do Banco: localhost
     • Nome do Banco: ee_user (o que você criou no passo 3)
     • Usuário do Banco: ee_user (mesmo nome do usuário criado anteriormente)
     • Senha do Banco: digite a senha definida no passo 3 para o ee_user.
   • Dados do Administrador: Crie o usuário super admin, incluindo nome de usuário, senha e e-mail. Use uma senha forte.
   • Configuração do Site: Inclua nome do site, URL, e outras informações básicas.

3. Finalize a Instalação

   Revise os dados fornecidos e clique em “Instalar” ou no botão correspondente. O ExpressionEngine criará as tabelas necessárias e fará as configurações iniciais.

   Ao finalizar, normalmente será exibida a página de login ou o painel administrativo.

Passo 6: Configurações Básicas Após a Instalação

Após instalar o núcleo do ExpressionEngine, é possível instalar plugins, templates ou realizar outras configurações iniciais.

1. Acesse o Painel Administrativo do ExpressionEngine

   Use o login criado durante a instalação para acessar o painel de administrador em https://servbay-ee.local/admin.php, informando usuário e senha.

2. Instale Plugins

   No painel, vá em “Developer” -> “Add-Ons” -> “Plugins”. Navegue pelas opções disponíveis e instale conforme sua necessidade.

3. Instale e Configure Templates

   Acesse “Design” -> “Templates”. Ali você pode criar grupos de templates, templates individuais e editar código HTML/CSS/EE para apresentar o conteúdo do site.

Construindo Seu Site com o ExpressionEngine

Com o ExpressionEngine instalado e configurado no ServBay, você pode começar a criar e gerenciar o conteúdo do seu site. Abaixo, algumas ações comuns para o início do projeto:

Crie Canais e Entradas

O núcleo do ExpressionEngine é formado por “Canais” e “Entradas”. Canais determinam o tipo e estrutura do conteúdo, enquanto entradas são instâncias destes conteúdos.

1. Criar Canal: No painel de controle, vá em “Content Structure” -> “Channels”. Clique em “Create New Channel”, preencha o nome do canal, grupo de campos, etc., e depois em “Save Channel”.
2. Criar Entrada: Vá em “Content” -> “Publish”. Selecione o canal recém-criado, preencha título, conteúdo (conforme os campos do canal) e demais campos, clicando em “Save” ao final.

Configure o Menu de Navegação

Menus de navegação costumam ser gerados por meio de templates.

1. Criar ou Editar Template: Acesse “Design” -> “Templates”, encontre ou crie um template para navegação (por exemplo, nav dentro do grupo site).
2. Insira o Código de Navegação: No template, use as tags do ExpressionEngine para recuperar entradas ou páginas e gerar a estrutura de navegação em HTML.
3. Inclua o Menu no Layout Principal: No template principal do layout, inclua a navegação com {% include 'site:nav' %} (caso use Blade) ou a tag correspondente.

Personalizando Widgets/Sidebars

Similar à navegação, áreas como barras laterais (“widgets”) podem ser criadas com templates dedicados.

1. Criar Template de Widget: Em “Design” -> “Templates”, crie um template para exibir o conteúdo do widget (por exemplo, site:sidebar).
2. Desenvolva o Código dos Widgets: No template, coloque código para mostrar últimos posts, categorias, anúncios, etc.
3. Inclua o Widget no Layout: Adicione o template do widget nos locais desejados do layout da página.

Perguntas Frequentes (FAQ)

• Pergunta: O que fazer se ao acessar https://servbay-ee.local/ for exibido erro de permissão?
  • Resposta: Verifique as permissões da pasta do projeto (/Applications/ServBay/www/servbay-ee-app) e de seus subdiretórios/arquivos. Assegure-se de que o usuário rodando o ServBay (geralmente você mesmo) possua permissão de leitura e escrita. Pode ser necessário usar o comando chmod ou chown, como sudo chown -R seuusuario:seugrupo /Applications/ServBay/www/servbay-ee-app.
• Pergunta: O instalador do ExpressionEngine indica que não consegue conectar ao banco de dados?
  • Resposta: Revise com atenção os dados informados (host localhost, nome do banco, usuário, senha) e veja se correspondem ao criado no phpMyAdmin. Certifique-se também de que o serviço MySQL/MariaDB do ServBay está em operação.
• Pergunta: Posso usar outros bancos do ServBay (como PostgreSQL)?
  • Resposta: O ExpressionEngine suporta principalmente MySQL/MariaDB. Caso o suporte a PostgreSQL seja oficial e haja drivers apropriados, é possível usar o serviço PostgreSQL do ServBay, mas depende da compatibilidade do próprio ExpressionEngine. Consulte a documentação oficial para saber quais bancos são suportados.

Resumo

Seguindo este passo a passo, você terá o ExpressionEngine CMS instalado e configurado no ServBay, pronto para desenvolvimento local. O ServBay oferece um ambiente ágil e conveniente, integrando tudo o que o ExpressionEngine precisa. Agora, você pode explorar toda a potência da plataforma para criar seu site ou aplicação web. Bom desenvolvimento!