deWeloPer

Ambiente de desenvolvimento WordPress com Docker

Este repositório contém a configuração necessária para criar um ambiente de desenvolvimento WordPress utilizando Docker. Inclui um container para o WordPress, um para o banco de dados MariaDB e um para o phpMyAdmin.

Pré-requisitos

• Docker
• Docker Compose

Estrutura do projeto

• plugins/: Diretório para os plugins do WordPress.
• themes/: Diretório para os temas do WordPress.

Evitar rastreamento de mudanças nas permissões dos arquivos

Por padrão, o Git rastreia mudanças nas permissões dos arquivos, como as permissões de execução. No entanto, em algumas situações, como quando você trabalha em um sistema de arquivos compartilhado ou em um sistema onde as permissões de arquivos são frequentemente alteradas por outros processos, como o Docker, você pode não querer que o Git rastreie essas mudanças. Definindo core.fileMode como false, você instrui o Git a ignorar essas alterações de permissão.

git config core.fileMode false

Configuração do ambiente

1. Clone o repositório:

   git clone git@github.com:everaldomatias/deweloper.git
   cd deweloper

Iniciando o ambiente

Para iniciar o ambiente de desenvolvimento pela primeira vez, use scripts da pasta ./scripts:

Para subir o ambiente pela primeira vez

./scripts/build.sh

Isso construirá as imagens Docker conforme definido no Dockerfile e iniciará os containers.

Para iniciar o ambiente de desenvolvimento após a instalação inicial, use o script:

./scripts/up.sh

Acessando o WordPress

Após iniciar os containers, você pode acessar o WordPress no seu navegador através do endereço: http://localhost

Acessando o painel administrativo do WordPress

http://localhost/wp-admin

Usuário: admin

Senha: admin

Acessando o phpMyAdmin

Para acessar o phpMyAdmin e gerenciar o banco de dados MariaDB, utilize o seguinte endereço: http://localhost:8080

• Usuário: root
• Senha: pass
• Servidor: db

Acessando o Mailhog

O Mailhog é um container com uma caixa de entrada de e-mails, ele registra todos e-mails enviados pelo WordPress. É importante saber que todos e-mails são deletados quando o container é encerrado.

Para acessar o Mailhog (caixa de entrada) acesse http://localhost:8025

Considerações adicionais

• As alterações feitas nos diretórios plugins e themes serão persistidas e refletidas diretamente no ambiente de desenvolvimento.
• A estrutura dos links permanentes é configurada automaticamente após a instalação do WordPress através do script entrypoint.sh para postname.

Problemas comuns

Pedindo credenciais FTP ao instalar plugins ou qualquer ação fora do container

Se o WordPress pedir credenciais FTP ao tentar instalar plugins/temas ou clonar plugins/temas, certifique-se de que as permissões dos diretórios plugins e themes estão corretas (substituindo $USER pelo seu usuário local, quando necessário):

sudo chown -R $USER:www-data plugins themes

sudo chmod -R 775 plugins themes

Ou se preferir, rode o script:

./scripts/fix-permissions.sh

Banco de dados não conectando

Se houver problemas de conexão com o banco de dados, certifique-se de que o container do MariaDB está funcionando corretamente e que as credenciais no docker-compose.yml estão corretas.

Contribuindo

Se você encontrar problemas ou tiver sugestões de melhorias, sinta-se à vontade para abrir uma issue ou enviar um pull request.

Licença

Este projeto está licenciado sob a Licença MIT. Veja o arquivo LICENSE para mais detalhes.