Como configurar variáveis de ambiente diferentes para produção e homologação no mesmo VPS

Olá, querido(a) desenvolvedor(a) e amigo(a) da GeHost! 🌟

Se você está aqui, provavelmente já sabe o quanto é importante ter ambientes separados: um para testar suas mudanças (homologação) e outro para o mundo real (produção). E sim, é possível fazer isso no mesmo VPS — sem precisar de múltiplos servidores. Vamos aprender juntos, passo a passo, como configurar variáveis de ambiente distintas para cada um desses cenários, com segurança e clareza.

Como você é cliente da GeHost, já tem acesso ao painel cPanel, onde gerenciamos tudo o que você precisa para seu site. Vamos usar apenas ferramentas que já estão disponíveis — nada de instalar coisas novas ou complicadas. É só seguir o guia com calma, como se fosse um ritual de desenvolvimento saudável. 🍵

Antes de começar: entenda o que são variáveis de ambiente

Imagine que seu site é um cozinheiro. Ele precisa de ingredientes diferentes para fazer um prato de teste (homologação) e outro para servir ao cliente (produção). As variáveis de ambiente são como os "ingredientes" que mudam conforme o contexto.

Exemplos comuns:

DB_HOST: onde está o banco de dados (local ou remoto?)
DEBUG: ativar mensagens de erro (só em homologação)
API_KEY: chave de acesso a serviços externos (diferente em cada ambiente)

Com isso, você evita expor dados sensíveis e garante que seu sistema se comporte corretamente em cada fase.

Dica do Sensei: Nunca coloque senhas, chaves ou dados sensíveis diretamente no código. Use variáveis de ambiente — é a forma mais segura e profissional.

Passo a passo: como fazer isso no seu VPS com cPanel

Como você está em um ambiente de hospedagem com cPanel (não é um VPS completo com root), vamos usar uma abordagem prática e segura, aproveitando o que já temos.

Organize suas pastas
No seu public_html, crie duas pastas separadas:
- homologacao
- producao
Essas pastas serão os “ambientes” onde seu projeto vai rodar.
Configure o .env para cada ambiente
Dentro de cada pasta, crie um arquivo chamado .env. Esse arquivo não será acessível via navegador, então é seguro.

Exemplo para homologacao/.env:
```
DB_HOST=localhost
DB_NAME=meu_site_homolog
DB_USER=homolog_user
DB_PASS=senha123
DEBUG=true
APP_ENV=homologacao
```
Exemplo para producao/.env:
```
DB_HOST=localhost
DB_NAME=meu_site_producao
DB_USER=prod_user
DB_PASS=senha_segura_aleatoria
DEBUG=false
APP_ENV=producao
```
Percebeu? As variáveis são diferentes. Isso evita que você quebre algo em produção por engano.
Use o arquivo .htaccess para definir o ambiente
No cPanel, acesse o Gerenciador de Arquivos ().

Na pasta homologacao, crie um arquivo chamado .htaccess com este conteúdo:
```
SetEnv APP_ENV homologacao
```
Na pasta producao, crie um .htaccess com:
```
SetEnv APP_ENV producao
```
Esse comando informa ao servidor que ambiente está sendo usado — e seu sistema pode ler isso automaticamente.
Configure domínios ou subdomínios
Para facilitar, use subdomínios:
- homologacao.seudominio.com → aponta para a pasta homologacao
- seudominio.com → aponta para producao
Para isso, vá no Editor de Zona de DNS () e crie dois registros:
- homologacao → tipo CNAME → aponta para seudominio.com
- www → tipo A → aponta para o IP do seu servidor (não precisa saber o IP — o cPanel faz isso automaticamente)
Pronto! Agora você acessa homologacao.seudominio.com e o sistema sabe que está em homologação.
Teste e confira
Acesse cada subdomínio e veja se o sistema está usando as variáveis corretas. Você pode criar um pequeno script de teste:

Em um arquivo chamado teste.php na pasta homologacao:
```
<?php
echo "Ambiente: " . $_ENV['APP_ENV'] . "<br>";
echo "Debug: " . (getenv('DEBUG') ? 'ativado' : 'desativado');
?>
```
Se aparecer "homologacao" e "ativado", tá funcionando! 🎉

Dicas práticas do Sensei

Evite cometer erros de produção: nunca faça alterações no ambiente de produção sem testar primeiro em homologação.
Use versões de código separadas: se usar Git, crie branches como main (produção) e develop (homologação).
Backup sempre: antes de mudar algo importante, faça um backup completo via cPanel ().
Se tiver dúvidas, chame o suporte: estamos aqui para te ajudar. Acesse o painel do cliente em painel.gehost.com.br e abra um ticket.

Um abraço do Sensei: Você está crescendo como desenvolvedor(a) com cada decisão consciente. Cada variável bem configurada é um passo seguro rumo ao sucesso. Continue assim — com foco, cuidado e paixão pelo que faz. 💙

Se este guia te ajudou, compartilhe com quem também está aprendendo. A GeHost está aqui para você, sempre.

Com carinho,
Sensei da GeHost
G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)

Como configurar variáveis de ambiente diferentes para produção e homologação no mesmo VPS