Aprender como alternar entre modo de produção e desenvolvedor via CLI no Magento é essencial para quem deseja manter a performance do site em alta em produção e, ao mesmo tempo, garantir um ambiente ideal para testes e desenvolvimento.
Essa prática é comum entre desenvolvedores, agências e donos de lojas Magento que desejam aplicar alterações com segurança e controlar melhor o comportamento da plataforma em diferentes cenários.
Neste artigo, você vai entender como alternar esses modos pelo terminal (CLI), quando usar cada um e quais cuidados tomar durante o processo.
O que são os modos do Magento 2?
O Magento 2 possui três modos de operação:
- Default (padrão) – Usado apenas para testes básicos, não recomendado para produção nem desenvolvimento avançado.
- Developer (desenvolvedor) – Ideal para ambientes de desenvolvimento. Gera erros detalhados e recompila arquivos a cada requisição.
- Production (produção) – Usado em sites em operação. Oferece máximo desempenho e segurança, mas sem exibir mensagens de erro completas.
Alternar entre esses modos garante mais controle sobre a experiência do usuário e facilita o trabalho da equipe técnica.
Por que usar a CLI para alternar os modos?
A CLI (Command Line Interface) do Magento é a forma mais rápida, segura e confiável de alternar entre os modos. Por meio do terminal, você pode:
- Consultar o modo atual
- Mudar de developer para production (e vice-versa)
- Automatizar a troca em scripts de implantação
- Evitar conflitos causados por cache ou arquivos não compilados
Como verificar o modo atual do Magento via CLI
Antes de fazer qualquer alteração, verifique em qual modo o seu Magento está operando. Execute o comando:
php bin/magento deploy:mode:show
O sistema irá retornar o modo atual: default, developer ou production.
Como alternar para o modo de desenvolvedor (developer)
O modo developer é recomendado para ambientes de desenvolvimento, homologação ou quando você precisa ajustar temas, extensões ou debugar o sistema.
Passo a passo:
- Acesse o terminal da sua loja Magento
- Execute o seguinte comando:
php bin/magento deploy:mode:set developer
- Aguarde a confirmação:
Enabled developer mode.
Recomendações:
- Limpe o cache após a mudança:
php bin/magento cache:clean php bin/magento cache:flush - Ideal para uso local ou em ambientes não públicos
Como alternar para o modo de produção (production)
O modo production garante máxima performance e é o único recomendado para sites em operação.
Passo a passo:
- Acesse o terminal e execute:
php bin/magento deploy:mode:set production
- O Magento pedirá para compilar arquivos estáticos e gerar o DI (Dependency Injection).
- Execute os seguintes comandos:
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
- Limpe e regenere o cache:
php bin/magento cache:clean
php bin/magento cache:flush
Dica:
- Faça backup antes da mudança, especialmente em servidores em produção
Diferenças entre os modos e quando usar cada um
| Recurso | Developer | Production |
|---|---|---|
| Velocidade de carregamento | Mais lenta | Mais rápida |
| Geração de arquivos estáticos | Dinâmica | Pré-compilada |
| Exibição de erros | Detalhada | Ocultada |
| Uso recomendado | Desenvolvimento | Loja ao vivo |
Erros comuns ao alternar os modos (e como evitar)
- Erro de permissão de arquivos
Corrija com: find var generated vendor pub/static pub/media -type d -exec chmod 775 {} \; find var generated vendor pub/static pub/media -type f -exec chmod 664 {} \; - Problemas de cache persistente
Sempre limpe os caches após qualquer alteração de modo. - Não compilar arquivos no modo production
Isso deixará seu site com aparência quebrada. Nunca pule osetup:di:compileestatic-content:deploy.
Conclusão: domine o uso da CLI e ganhe produtividade
Saber como alternar entre modo de produção e desenvolvedor via CLI no Magento permite que você gerencie sua loja com mais eficiência, segurança e flexibilidade. Essa habilidade é fundamental tanto para desenvolvedores quanto para empresários que desejam manter controle sobre o ambiente da aplicação.
Para aprofundar seu conhecimento, acesse nosso conteúdo complementar:
👉 O que é o modo de produção e modo de desenvolvedor no Magento
