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

🛠️ Ferramentas: Laravel, Mailpit, MySQL, DBGate

⚡ 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 no VSCode.

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 no GitHub)

git clone url_https_do_seu_repositório

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

cd pasta_do_projeto
code .

4. Clique no botão Reabrir no Contêiner que aparece no canto inferior direito. Nesse momento o VSCode será reaberto dentro do contexto do container Docker (conforme indicado em docker-compose.yml).

5. O container estará pronto quando indicar Dev Container: laravel_11 no canto inferior esquerdo do VSCode.

6. Crie um projeto LARAVEL 11:

ATENÇÃO: Se o Laravel ainda não foi importado, é necessário executar o comando /var/www/create_laravel.sh no terminal do VSCode dentro do container. Esse comando vai importar o Laravel e fazer o Build dos pacotes NodeJS, o projeto estará disponível na pasta /var/www/html.

7. Algumas extensões VSCode 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 clique no ícone de nuvem, selecione as extensões que deseja instalar e clique em Ok.

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

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

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

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

Para encerrar a utilização do container, clique em Dev Container: laravel_11 no canto inferior esquerdo do VSCode e logo em seguida escolha a opção Close Remote Connection. SEMPRE faça isso ANTES de fechar o VSCode.

ATENÇÃO: Conforme indicado no arquivo docker-compose.yml, os serviços serão inicializados no modo HOST, logo, caso já exista algum programa instalado no Linux utilizando alguma das portas informadas no docker-compose.yml, será necessário modificar esse arquivo e inserir novos números de porta para os serviços.

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(https://localhost:9443) para excluir algum container já existente.

docker ps # lista containers em execução. Identifique o NAME do container.

docker container ls -a # lista containers ocultos. Identifique o NAME do container.

docker container rm NAMECONTAINER # EXCLUI o container "NAMECONTAINER"

ATENÇÃO: Os arquivos do servidor MySQL serão ignorados pelo Git. Portanto, sempre faça o DUMP (exportar) do banco de dados quando quiser executar seu projeto em outro computador. 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. Basta salvar esse arquivo na raiz do projeto e versionar normalmente para o GitHub.

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