ServBay

Português

English
简体中文
繁體中文
Español
العربية
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Bahasa Melayu
Polski
Nederlands
Українська
ไทย
한국어

Português

English
简体中文
繁體中文
Español
العربية
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Bahasa Melayu
Polski
Nederlands
Українська
ไทย
한국어

Appearance

Instalando e Configurando Bedrock no ServBay ​

Visão geral ​

Este documento irá guiá-lo no processo de instalação e configuração do Bedrock no ambiente de desenvolvimento local ServBay. O Bedrock proporciona uma estrutura moderna para projetos WordPress, utilizando o Composer para gerenciar dependências, otimizando a gestão de configurações e seguindo as melhores práticas para tornar o desenvolvimento, implantação e manutenção de projetos WordPress mais eficientes e seguros. Com o poder e a facilidade de gerenciamento do ambiente local oferecido pelo ServBay, você conseguirá criar um ambiente para desenvolvimento com Bedrock rapidamente.

O que é Bedrock? ​

O Bedrock é uma estrutura de projeto WordPress criada pela equipe Roots, projetada para aprimorar a experiência de desenvolvimento com WordPress. Ele difere significativamente da estrutura tradicional do WordPress, com características principais como:

  • Gerenciamento de dependências via Composer: O núcleo do WordPress, temas e plugins podem ser gerenciados pelo Composer, simplificando atualizações e resolução de conflitos de dependências.
  • Gestão de configuração aprimorada: Seguindo os princípios do Twelve-Factor App, utiliza o arquivo .env para gerenciar variáveis de ambiente, separando configuração do código para mais segurança e flexibilidade.
  • Melhor organização de projeto: O núcleo do WordPress fica em um subdiretório próprio (web/wp), enquanto temas e plugins ficam em web/app, tornando a estrutura mais clara.
  • Segurança reforçada: Inclui medidas de segurança como ocultação dos caminhos para os arquivos do núcleo por padrão.

O Bedrock é a escolha ideal para construir aplicações WordPress mais robustas, modernas e fáceis de manter.

Por que escolher o ServBay para desenvolver com Bedrock? ​

O ServBay é uma ferramenta de ambiente de desenvolvimento web local criada para macOS, integrando servidores web populares (Caddy/Nginx/Apache), múltiplas versões do PHP, sistemas de banco de dados (MySQL/PostgreSQL/MongoDB) e ambientes de linguagens como Node.js, Python, Go e Java. Ao utilizar ServBay com Bedrock, você pode:

  • Configuração rápida de ambiente: O ServBay já vem com PHP, Composer e bancos de dados necessários para o Bedrock, evitando instalações e configurações manuais.
  • Troca de versões com flexibilidade: Troque facilmente a versão do PHP para testar a compatibilidade do Bedrock com diferentes versões do PHP.
  • Gerenciamento integrado de banco de dados: Use o phpMyAdmin ou Adminer incluído para criar e gerenciar bancos de dados necessários ao Bedrock de modo prático.
  • Configuração simplificada de sites: Configure rapidamente o site (host virtual) do projeto Bedrock via interface gráfica do ServBay e aponte para o diretório correto.
  • Gerenciamento unificado: Gerencie todos os pacotes e sites necessários para desenvolvimento local em um só aplicativo.

Pré-requisitos ​

Antes de começar a instalação, verifique se você atende aos seguintes requisitos:

  • ServBay instalado e em execução no macOS.
  • Conhecimento básico de linha de comando.
  • Noções básicas sobre Composer (embora comandos específicos sejam fornecidos neste guia).

Passos para Instalar o Bedrock ​

Nesta seção, veja o passo a passo para instalar e configurar um projeto Bedrock no ServBay.

Passo 1: Criar o diretório do projeto ​

Primeiro, navegue até o diretório padrão de sites do ServBay em /Applications/ServBay/www e crie um novo diretório para o projeto. Sugerimos usar um nome descritivo como servbay-bedrock-app.

bash
cd /Applications/ServBay/www
mkdir servbay-bedrock-app
cd servbay-bedrock-app

Esse diretório será o diretório raiz do seu projeto Bedrock.

Passo 2: Criar o projeto Bedrock com Composer ​

O ServBay já inclui o Composer, então você pode usar o comando composer diretamente no terminal. Na pasta do projeto recém-criada (/Applications/ServBay/www/servbay-bedrock-app), execute o seguinte comando do Composer para criar o projeto Bedrock:

bash
composer create-project roots/bedrock .

Esse comando baixa a versão mais recente do Bedrock e todas as suas dependências para o diretório atual (.). O tempo desse processo pode variar conforme a velocidade da sua internet.

Passo 3: Criar banco de dados e usuário ​

O Bedrock e o WordPress precisam de um banco de dados para armazenar conteúdo e configurações. Iremos utilizar o phpMyAdmin incluído no ServBay para criar o banco de dados e o usuário correspondente.

  1. Acesse o phpMyAdmin do ServBay

    Abra o navegador e acesse o endereço local https://servbay.host/. Na página de boas-vindas do ServBay, localize e clique no link “phpMyAdmin” para entrar na interface de administração do banco de dados.

  2. Crie um usuário para o banco de dados

    Para segurança e organização, crie um usuário e um banco de dados exclusivos para cada projeto.

    1. Acesse a página de contas de usuários

      No phpMyAdmin, clique em “Contas de usuário” no menu superior de navegação.

    2. Adicione um novo usuário

      Clique em “Adicionar conta de usuário”. Preencha as informações conforme indicado:

      • Nome de usuário: Escolha um nome para o usuário desse projeto, por exemplo bedrock_user.
      • Nome do host: Selecione localhost. Isso garante que o usuário só possa se conectar localmente.
      • Senha: Insira uma senha segura para esse usuário. Guarde essa senha. Por exemplo, utilize password123 para testes locais, mas use uma senha forte em ambiente de produção.
      • Repetir: Insira novamente a senha definida.

      Na seção “Criar banco de dados para o usuário”, selecione “Criar um banco de dados com o mesmo nome e conceder todos os privilégios”. Isso vai criar automaticamente um banco de dados chamado bedrock_user e garantir ao usuário bedrock_user todas as permissões sobre este banco.

      Certifique-se de marcar a caixa “Conceder todos os privilégios” para garantir que este usuário tenha todas as permissões necessárias.

      Clique no botão “Executar” na parte inferior da página para finalizar a criação do usuário e do banco de dados.

Passo 4: Configurar o Bedrock ​

Bedrock utiliza variáveis de ambiente, normalmente armazenadas no arquivo .env na raiz do projeto.

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

    No diretório raiz do projeto Bedrock (/Applications/ServBay/www/servbay-bedrock-app), encontre o arquivo de exemplo chamado .env.example. Faça uma cópia e renomeie para .env:

    bash
    cp .env.example .env

    O arquivo .env é usado para configuração real do projeto; o .env.example é apenas um exemplo e não contém informações sensíveis.

  2. Edite o arquivo .env

    Abra o arquivo .env copiado com seu editor de texto preferido (VS Code, Sublime Text, Nano, etc). Localize as configurações de conexão com o banco de dados e ajuste conforme o banco e usuário que você criou no passo anterior:

    dotenv
    # Banco de dados
DB_NAME='bedrock_user' # Nome do banco de dados, igual ao nome de usuário
DB_USER='bedrock_user' # Usuário do banco de dados
DB_PASSWORD='password123' # Senha do banco de dados
DB_HOST='localhost' # Endereço do servidor do banco, normalmente localhost no ServBay local
DB_PREFIX='wp_' # Prefixo das tabelas, pode deixar padrão ou alterar

# Ambiente WordPress
WP_ENV='development' # Ambiente: development, staging, production, etc

# URLs do site
WP_HOME='http://servbay-bedrock.local' # URL completa do site
WP_SITEURL='${WP_HOME}/wp' # URL do núcleo WordPress

    Ajuste os valores conforme sua configuração, especialmente DB_PASSWORD utilizando a senha definida no phpMyAdmin.

    WP_HOME e WP_SITEURL determinam como você acessa o site no navegador. servbay-bedrock.local é um domínio local comum, mas sinta-se livre para alterar. WP_SITEURL aponta para o subdiretório (web/wp) onde ficam os arquivos principais do WordPress.

    No arquivo .env também é possível configurar outras opções do Bedrock e WordPress, como constantes personalizadas, envio de e-mails etc.

Passo 5: Configurar o servidor web (Site no ServBay) ​

Para o ServBay servir corretamente o seu projeto Bedrock, adicione um novo site (host virtual) no aplicativo.

  1. Adicionar novo site

    No aplicativo ServBay, clique na aba “Sites” na barra lateral. Clique no botão “+” ou “Adicionar site” para criar a nova configuração. Preencha estas informações:

    • Nome: Um nome de identificação para o site, por exemplo, My Bedrock Site (uso interno do ServBay).
    • Domínio: Insira o domínio definido em WP_HOME no .env, por exemplo, servbay-bedrock.local. O ServBay irá mapear automaticamente para o local (127.0.0.1).
    • Tipo de site: Selecione PHP.
    • Versão do PHP: Escolha uma versão compatível com o Bedrock. Geralmente, opte pela versão mais recente e estável disponível no ServBay.
    • Diretório raiz do site: Atenção especial aqui. O diretório raiz não é a pasta do projeto, mas sim o subdiretório web, ou seja, /Applications/ServBay/www/servbay-bedrock-app/web.

  2. Salvar configurações

    Após preencher tudo, clique para salvar. O ServBay atualizará automaticamente a configuração do servidor web. Se o aplicativo pedir para reiniciar algum serviço, siga a recomendação.

Passo 6: Finalizar a instalação do WordPress ​

Agora que o projeto Bedrock está pronto e o site configurado no ServBay, basta concluir a instalação tradicional do WordPress via navegador.

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

    No navegador, acesse o endereço definido como WP_SITEURL no .env e na configuração do site, como http://servbay-bedrock.local/wp. Se tudo estiver correto, aparecerá o assistente de instalação do WordPress.

  2. Informe os dados do banco de dados

    O instalador WordPress pedirá as informações do banco de dados criadas no passo anterior:

    • Nome do banco: bedrock_user (igual ao usuário)
    • Usuário: bedrock_user
    • Senha: A senha que você definiu (password123 ou outra)
    • Host do banco: localhost
    • Prefixo das tabelas: wp_ (deixe padrão, salvo necessidade específica)

    Clique em “Enviar” e o WordPress tentará se conectar ao banco.

  3. Preencha as informações do site

    Quando a conexão for bem-sucedida, configure:

    • Título do site: Nome do seu site.
    • Usuário: Nome de usuário do administrador.
    • Senha: Defina uma senha forte.
    • Seu e-mail: E-mail do administrador.
    • Visibilidade para mecanismos de busca: Em ambiente local, recomenda-se marcar “Impedir que mecanismos de busca indexem este site”.

  4. Finalizar instalação

    Clique em “Instalar WordPress”. O processo finaliza, criando as tabelas necessárias no banco. Ao final, surgirá a mensagem de sucesso e você poderá clicar para acessar o painel administrativo.

Passo 7: Instalar temas e plugins (via Composer) ​

O Bedrock incentiva que temas e plugins sejam gerenciados via Composer, em vez da interface padrão do WordPress.

  1. Encontre o nome do pacote Composer do tema/plugin

    Muitos temas e plugins populares têm pacotes disponíveis no Packagist (packagist.org) ou WordPress Packagist (wpackagist.org), normalmente no formato vendor/nome-do-pacote, por exemplo: wpackagist-theme/twentytwentyone ou wpackagist-plugin/wordpress-seo.

  2. Instale usando Composer

    No diretório raiz do projeto Bedrock (/Applications/ServBay/www/servbay-bedrock-app), rode:

    Para instalar tema:

    bash
    composer require wpackagist-theme/your-theme-name

    Para instalar plugin:

    bash
    composer require wpackagist-plugin/your-plugin-name

    Substitua your-theme-name e your-plugin-name pelos nomes reais. O Composer instalará o tema em web/app/themes e o plugin em web/app/plugins.

  3. Ative pelo painel WordPress

    Faça login no painel administrativo (http://servbay-bedrock.local/wp/wp-admin/):

    • Temas: Vá em “Aparência” > “Temas”, encontre e ative o tema instalado.
    • Plugins: Vá em “Plugins” > “Plugins instalados”, encontre e ative o plugin.

    Embora Bedrock permita instalação manual via upload de .zip pelo admin WordPress, o método via Composer é o recomendado por ser moderno e facilmente replicável.

Construindo seu site com Bedrock ​

Agora você tem o Bedrock instalado e configurado no ambiente local com ServBay. Use o WordPress como de costume, mas aproveitando as vantagens modernas que o Bedrock oferece.

  • Criar páginas e posts: Acesse o painel WordPress, use os menus “Páginas” e “Posts” normalmente.
  • Configurar menus de navegação: Em “Aparência” > “Menus” ajuste a navegação do site.
  • Customizar widgets: Em “Aparência” > “Widgets” gerencie conteúdo de barras laterais etc.
  • Desenvolvimento de temas e plugins: Para desenvolvedores, use web/app/themes e web/app/plugins para criar customizações.
  • Gerenciamento de configuração: Aproveite o arquivo .env para gerenciar diferentes ambientes (desenvolvimento, staging, produção).

Perguntas Frequentes (FAQ) ​

  • Pergunta: Recebo erro 404 ao acessar http://servbay-bedrock.local. O que fazer?
    • Resposta: Confirme se o domínio do site está igual ao cadastrado no ServBay.
    • Resposta: Verifique se o diretório raiz está correto em /Applications/ServBay/www/servbay-bedrock-app/web.
    • Resposta: Certifique-se que o servidor web do ServBay está rodando.
    • Resposta: Confira se WP_HOME está correto no arquivo .env.
  • Pergunta: Vejo erro de conexão com o banco em http://servbay-bedrock.local/wp. O que faço?
    • Resposta: Confira se DB_NAME, DB_USER, DB_PASSWORD, DB_HOST no .env correspondem ao que foi criado no phpMyAdmin.
    • Resposta: Certifique-se que o serviço MySQL (ou outro banco) do ServBay está ativo.
    • Resposta: Veja se o usuário criado tem os privilégios totais no banco de dados.
  • Pergunta: Instalei tema/plugin via Composer, mas não aparece no admin WordPress. Por quê?
    • Resposta: Execute composer install ou composer require no diretório do projeto e veja se a operação foi realizada com sucesso.
    • Resposta: Os temas instalados estão em web/app/themes e plugins em web/app/plugins. Verifique se os arquivos foram realmente baixados.
    • Resposta: No painel WordPress, vá em “Aparência” > “Temas” ou “Plugins” > “Plugins instalados” e ative-os manualmente.
  • Pergunta: Como atualizar Bedrock, núcleo do WordPress, temas ou plugins?
    • Resposta: Atualize via Composer: execute composer update no diretório do projeto para tudo, ou composer update vendor/nome-do-pacote para itens específicos. Após atualizar, pode ser necessário executar atualizações de banco no painel WordPress.

Resumo ​

Seguindo os passos acima, você configurou com sucesso o Bedrock no ambiente local do ServBay. Ao unir o gerenciamento prático de ambientes do ServBay à estrutura moderna do Bedrock, você poderá desenvolver e manter projetos WordPress com mais praticidade e segurança. Agora, é só aproveitar as vantagens do Bedrock para criar seu próximo site WordPress!