Instalar e Configurar o OctoberCMS no Ambiente ServBay

O que é o OctoberCMS?

O OctoberCMS é um sistema de gerenciamento de conteúdo (CMS) de código aberto baseado no framework Laravel. Ele oferece funcionalidades poderosas e uma flexibilidade de extensão, ideal para construir todos os tipos de sites. O OctoberCMS é conhecido por sua interface de usuário simples e características amigáveis para desenvolvedores.

Passos para instalar o OctoberCMS

Neste artigo, vamos mostrar como instalar e configurar o OctoberCMS no ambiente ServBay.

Passo 1: Criar o diretório do projeto

Primeiro, crie um novo diretório de projeto no diretório www do ServBay:

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

Passo 2: Instalar o OctoberCMS usando o Composer

O ServBay já vem com o Composer incluso, portanto, podemos usar o Composer diretamente para instalar o OctoberCMS:

composer create-project october/october .

Passo 3: Criar banco de dados e usuário

1. Acessar a ferramenta de gerenciamento de banco de dados phpMyAdmin inclusa no ServBay

   Abra https://servbay.host/, clique em "phpMyAdmin" para acessar a ferramenta de gerenciamento de banco de dados phpMyAdmin.

2. Criar o usuário do banco de dados

   1. Acessar a página de contas de usuário

      • Na página principal do phpMyAdmin, clique no menu superior em "Contas de usuário".

   2. Adicionar novo usuário

      • Clique em "Adicionar conta de usuário".
      • Preencha as seguintes informações:
        • Nome de usuário: october_user
        • Nome do host: localhost
        • Senha: insira uma senha segura, por exemplo, senha123
        • Reentrar: insira a senha novamente
      • Na seção "Banco de dados para o usuário", selecione "Criar banco de dados com o mesmo nome e conceder todos os privilégios".
      • Certifique-se de marcar "Conceder todos os privilégios".
      • Clique no botão "Executar".

Passo 4: Configurar o Servidor Web

1. Adicionar novo site

   Abra o ServBay, clique na aba "Hosts" e adicione um novo site:

   • Nome: Meu Site OctoberCMS
   • Domínio: servbay-octobercms.local
   • Tipo de site: PHP
   • Versão do PHP: selecione a versão do PHP correspondente
   • Diretório raiz do site: /Applications/ServBay/www/servbay-octobercms-app

2. Salvar configuração

   Salve a configuração e reinicie o ServBay.

Passo 5: Configurar o OctoberCMS

1. Editar o arquivo de configuração do ambiente

   No diretório raiz do projeto, copie o arquivo .env.example para .env:

   cp .env.example .env

2. Editar o arquivo .env

   Abra o arquivo .env em um editor de texto e configure a conexão do banco de dados e outras configurações necessárias:

   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=october_user
   DB_USERNAME=october_user
   DB_PASSWORD=senha123

Passo 6: Executar o instalador do OctoberCMS

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

   Abra o navegador e acesse https://servbay-octobercms.local/install.php para ver a página de instalação do OctoberCMS.

2. Preencher informações do banco

   Siga as instruções na página para preencher as informações de conexão com o banco de dados:

   • Tipo de banco: MySQL
   • Host do banco de dados: localhost
   • Nome do banco: october_user (mesmo nome do usuário)
   • Usuário do banco: october_user
   • Senha do banco: senha123

3. Preencher informações do administrador

   Siga as instruções na página para preencher o nome de usuário e senha do administrador.

4. Finalizar a instalação

   Clique no botão "Instalar" para concluir o processo de instalação.

Passo 7: Instalar plugins e temas

1. Instalar plugins

   Faça login no painel de administração do OctoberCMS, clique em "Plugins", procure e instale os plugins necessários.

2. Instalar temas

   Clique em "Aparência" -> "Temas", escolha e instale um tema de sua preferência.

Usando o OctoberCMS para construir um site

Agora que você instalou e configurou com sucesso o OctoberCMS no ambiente ServBay, pode começar a usá-lo para criar seu site. Aqui estão algumas operações comuns:

Criar páginas e conteúdos

1. Criar página

   No painel de administração do OctoberCMS, clique em "CMS" -> "Páginas", crie uma nova página, preencha o título e o conteúdo da página, e clique em "Salvar".

2. Criar blocos de conteúdo

   Clique em "CMS" -> "Conteúdo", crie um novo bloco de conteúdo, preencha o título e o conteúdo, e clique em "Salvar".

Configurar o menu de navegação

1. Criar menu

   No painel de administração do OctoberCMS, clique em "CMS" -> "Partes", crie uma nova parte para o menu de navegação.

2. Adicionar itens ao menu

   Adicione páginas e blocos de conteúdo ao menu de navegação e clique em "Salvar".

Personalizar widgets

1. Adicionar widget

   No painel de administração do OctoberCMS, clique em "CMS" -> "Partes", crie uma nova parte para widgets.

2. Configurar widget

   Configure as definições do widget conforme necessário e clique em "Salvar".

Seguindo estes passos, você terá instalado e configurado o OctoberCMS no ambiente ServBay e começado a usar a plataforma para construir seu site. O OctoberCMS é uma escolha ideal para criar diversos tipos de sites, graças às suas funcionalidades poderosas e flexibilidade.