📦 Este repositório oferece um Dev Container pré-configurado para construir aplicações web com Laravel e MySQL no VSCode.

🛠️ Ferramentas: Laravel, Mailpit, Swoole, MySQL, DBGate

🚀 Framework Laravel: projeto Laravel gerado automaticamente.

⚡ Início rápido: Elimine as complexidades de configuração e foque na codificação.

📥 Crie um novo repositório baseado neste template.

🔗 Crie sua conta Docker Hub.

🐧 Utilize alguma distribuição LINUX. 🐧

🐳 Verifique se instalou o Docker.

💻 Verifique se instalou o Git.

💻📝 Verifique se instalou o VSCode.

📦 Verifique se instalou a extensão Dev Containers.

ATENÇÃO: Para utilizar MySQL e DBGate, basta remover os comentários no arquivo docker-compose.yml

1. Entre na sua conta Docker Hub.

2. Clone o seu repositório (copie a URL HTTPS)

git clone url_https_do_seu_repositório

3. Abrir o projeto no VSCode. instale a extensão Dev Containers

cd pasta_do_projeto
code .

4. Click no botão Reabrir no Contêiner que aparece no canto inferior direito. O VSCode vai criar o contêiner para executar os arquivos do projeto que também serão gerados na pasta project ou outra indicada no arquivo docker-compose.yml.

5. Algumas extensões serão instaladas automaticamente. Pode instalar outras normalmente ou obter as extensões já ativadas no seu VSCode. Para isso vá na aba de extensões, depois click no ícone de nuvem, selecione todas e clicque em Ok.

É possível escolher extensões a serem instaladas automaticamente no arquivo .devcontainer/devcontainer.json

🌐 Acesse seu projeto Laravel ➡️ http://localhost:8009 no navegador.

🌐 Acesse o DBGate ➡️ http://localhost:8010 no navegador.

🌐 Acesse o Mailpit ➡️ http://localhost:8025 no navegador.

ATENÇÃO: Para criar NOVOS PROJETOS, altere apenas o nome do lado esquerdo na diretiva volumes do arquivo docker-compose.yml. O Docker vai preparar um novo projeto Laravel nessa nova pasta sem interferir nas pastas dos outros projetos. O /app é o diretório padrão usado dentro do container, logo, não precisa ser modificado.

ATENÇÃO: Se houver algum conflito com nomes de Contêiners, utilize os seguintes comandos Docker para solucionar o problema. Também pode utilizar as interfaces gráficas Docker Desktop ou Portainer.

docker ps

docker ps -a

docker container ls -a

docker container rm NOMECONTAINER

ATENÇÃO: O servidor MySQL é compartilhado entre os projetos. No entanto, basta configurar a conexão no DBGate utilizando o usuário root para criar um novo banco de dados em cada projeto. Portanto, não é necessário criar uma pasta nova para o MySQL em cada projeto.

Para EXPORTAR algum banco de dados no DBGate, clique com o botão direito do mouse no título do banco de dados e depois clique em Backup/export SQL Dump. O arquivo SQL gerado ficará salvo na aba Favoritos.

Contribuições são muito bem-vindas! Mande pull request com melhorias, correções ou ideias novas.