b4commerce/laravel repository overview

⁠Docker de desenvolvimento

Foi criado uma imagem docker com exatamente as mesmas configurações dos containers de produção e adicionado as principais ferramentas de desenvolvimento como git, aws cli e xdebug

Para utilizar essa imagem basta executar o comando abaixo

docker run --rm -v $PWD:/var/www -v ~/.composer:/root/.composer -p <PORTA>:80 -u ${UID} -it b4commerce/desenvolvimento:7.3

Explicação do comando

• docker run roda um container docker
• --rm após terminar de rodar o container o mesmo será apagado para não deixar lixos na maquina
• -v origin:destino monta um volume fazendo o bind entre o diretório na sua maquina e o diretório dentro do container
• $PWD pega o diretório corrente aonde está sendo executado o comando
• /var/www pasta padrão do container para rodar a aplicação
• -v ~/.composer:/root/.composer faz o bind da sua pasta de cache do seu composer para que o conteiner aproveite o cache das dependencias que você já possui
• <porta> porta na sua maquina aonde a aplicação irá rodar caso configure aqui como 8080 sua aplicação estará disponível na url http://localhost:8080⁠
• -p <PORTA>:80 faz o bind entre a porta no seu host e a porta onde o nginx está rodando dentro do container
• -u ${UID} roda o container com o seu usuário local para não dar diferença de permissão
• -it habilita o modo iterativo do console (se o console precisar de alguma confirmação você conseguirá digitar uma resposta e enviar para o container)
• b4commerce/desenvolvimento:7.3 imagem da b4commerce para aplicações laravel com php versão 7.3

⁠Config XDebug

1. Criar um server PHP no PHPSTORM

   File -> Settings -> Languages & Frameworks -> PHP -> Servers 
   

   Copy

   Clicar no + para adicionar um novo server

   

   • Escolher um nome para o server
   • informar a url e porta aonde o container docker está rodando
   • Marcar o check box "Use path mappings"
   • Em "Project Files" na linha onde aparece a pasta da aplicação fazer o link com a pasta do container /var/www

   OBS: Esse mapeamento serve para o XDebug saber em qual pasta está o arquivo na sua maquina em relação ao mesmo arquivo dentro do container

2. Adicione a configuração de debug

   

   Click em + e selecionde "PHP Remote Debug"

   

   Configure os dados de debug

   

   • Name: nome da configuração
   • Marque a opção "Filter debug connection by IDE key"
   • Server: selecione o server criado no passo anterior
   • IDE key(session id): SEMPRE deve ser preenchido "docker" essa chave já está configurada na imagem b4commerce/desenvolvimento

3. Ative o debug

   

4. Usar

   Se você fez tudo certo até aqui, nesse momento o debug já deve estar funcionando