Variáveis de ambiente separadas para produção e homologação — o guia completo da Sensei 🧑💻
Oi! Aqui é a Sensei da GeHost 😊 Se você já teve aquele susto de testar uma novidade no site e ela aparecer direto pros seus clientes verem, esse guia é pra você. Vou te ensinar, com calma e sem termos complicados, a separar o ambiente de produção (o site "de verdade", que o público acessa) do ambiente de homologação (onde você testa antes de publicar) — cada um com suas próprias configurações e variáveis de ambiente.
💡 O que é "variável de ambiente"? É uma configuração que o seu sistema lê pra saber "onde eu estou rodando" — por exemplo, qual banco de dados usar, qual chave de API chamar, ou se deve mostrar mensagens de erro detalhadas (bom pra teste) ou escondidas (obrigatório em produção). Separar isso evita que um teste "vaze" pro ambiente real.
Por que separar produção e homologação?
- Você testa mudanças sem arriscar o site que seus clientes/visitantes já usam;
- Evita misturar dados de teste com dados reais (pedidos, cadastros, pagamentos);
- Se algo quebrar no teste, ninguém além de você percebe.
Passo 1 — Organize os ambientes em pastas ou subdomínios diferentes
O jeito mais simples e seguro de manter tudo separado é ter duas pastas (ou dois subdomínios) diferentes — por exemplo, homologacao.seudominio.com.br apontando para uma pasta de teste, e o seu domínio principal apontando pra pasta de produção. Assim cada ambiente tem seu próprio conjunto de arquivos, sem risco de um sobrescrever o outro.
Acesse o cPanel do seu plano em painel.gehost.com.br e faça login normalmente:
Dentro do painel, você vai usar o grupo de ferramentas de Domínios pra criar o subdomínio de homologação (ex.: homologacao.seudominio.com.br), e o grupo de Arquivos pra organizar as pastas de cada ambiente:
Passo 2 — Crie um arquivo de configuração (.env) para cada ambiente
Agora vamos criar um arquivo separado com as configurações de cada ambiente. Esse arquivo costuma se chamar .env (ou "config.php", "settings.py", dependendo do seu sistema) e é onde ficam as informações como usuário e senha do banco, chaves de integração e o "modo" do site (produção ou teste).
- Abra o Gerenciador de Arquivos no cPanel;
- Entre na pasta do ambiente de produção (geralmente public_html) e confira ou crie o arquivo .env com os dados reais (banco de produção, modo "produção" desligando mensagens de erro detalhadas);
- Entre na pasta do ambiente de homologação e crie outro .env, com os dados de teste (outro banco, modo "debug" ligado, se seu sistema tiver essa opção).
⚠️ Nunca use o banco de dados de produção no ambiente de teste! Se algo der errado num teste, você pode acabar apagando ou corrompendo dados reais de clientes. Sempre um banco pra cada ambiente.
Passo 3 — Crie um banco de dados separado para homologação
No cPanel, vá até Bancos de Dados MySQL e crie um novo banco exclusivo para os testes (ex.: seusite_homolog), com seu próprio usuário e senha — diferente do banco de produção:
Depois, coloque esses dados (nome do banco, usuário e senha) no arquivo .env da pasta de homologação, exatamente como fez no passo 2.
Passo 4 — Proteja o arquivo .env de acesso externo
Esse arquivo tem informações sensíveis (senhas, chaves), então ele nunca pode ficar acessível por quem visita seu site. Se seu sistema não faz isso sozinho, você pode restringir o acesso direto ao arquivo pelo próprio Gerenciador de Arquivos, ajustando as permissões, ou pedindo orientação ao nosso suporte se tiver dúvida em como fazer isso no seu sistema específico.
Passo 5 — Antes de publicar de verdade
- Teste tudo à vontade no ambiente de homologação — pode "quebrar" sem medo, é pra isso que ele existe;
- Confirmado que está tudo certo, aplique as mesmas mudanças (com as configurações de produção, não as de teste!) na pasta principal do site;
- Sempre confira, antes de publicar, se o arquivo .env da produção está com os dados de produção — é um erro comum (e chato) publicar um site "achando" que está em produção, mas com configuração de teste ativa.
🌟 Dica de ouro da Sensei: dê nomes bem claros pras suas pastas e bancos ("producao" e "homologacao"), assim fica impossível confundir na hora de mexer. Organização simples evita 90% dos sustos!
Precisa de uma força?
Se você contratou algum dos nossos serviços recentemente, lembre-se: você tem 30 dias de suporte gratuito após a entrega pra tirar dúvidas como essa com a gente. Fora esse período, é só abrir um chamado pelo painel.gehost.com.br que a equipe te ajuda a configurar os ambientes certinho. Bora deixar seu site seguro e organizado! 💛