Como configurar variáveis de ambiente por ambiente (dev/staging/produção) no VPS

Como configurar variáveis de ambiente por ambiente (dev/staging/produção) no VPS

Olá, amigo(a) desenvolvedor(a)! Seja bem-vindo(a) ao seu novo passo na jornada de desenvolvimento com foco em qualidade e segurança. Aqui na GeHost, entendemos que cada projeto tem seu ritmo — e é por isso que você precisa de controle total sobre como seu aplicativo se comporta em diferentes ambientes: desenvolvimento (dev), teste (staging) e produção.

Este guia vai te mostrar, de forma simples e clara, como organizar suas variáveis de ambiente de forma inteligente, sem precisar mudar códigos ou se preocupar com segurança. Vamos lá, com calma e foco — você está no caminho certo!

O que são variáveis de ambiente?

Imagine que você tem um app que se conecta a um banco de dados. Em desenvolvimento, você usa um banco local. Em produção, usa um banco seguro e remoto. Como o código sabe qual usar?

É aí que entram as variáveis de ambiente. Elas são como "comandos secretos" que seu app lê ao iniciar — sem precisar alterar o código. Assim, você pode ter o mesmo código rodando em diferentes ambientes com configurações distintas.

Dica Sensei: Nunca coloque senhas, chaves de API ou URLs de banco de dados diretamente no código. Isso é como deixar a chave da casa na porta. Use variáveis de ambiente — elas são a sua armadura!

Como configurar variáveis por ambiente no VPS (GeHost)

Apesar de nossos planos serem baseados em cPanel, você tem acesso completo ao servidor (VPS) e pode configurar variáveis de ambiente de forma segura. Vamos ao passo a passo:

1. Entre no painel do cliente em painel.gehost.com.br.
2. Na aba “Servidores”, localize seu VPS e clique em “Acessar SSH”.
3. Use um cliente SSH (como PuTTY ou o terminal do seu sistema) para conectar-se ao servidor com suas credenciais.
4. Depois de logado, vá até a pasta onde seu projeto está hospedado. Geralmente, é em /home/seu_usuario/public_html ou em um subdiretório como /home/seu_usuario/projetos/seu_app.

Com o projeto localizado, vamos criar arquivos de configuração específicos para cada ambiente.

Crie arquivos de variáveis para cada ambiente

Na raiz do seu projeto, crie arquivos com nomes como:

• .env.dev — para ambiente de desenvolvimento
• .env.staging — para teste (staging)
• .env.production — para produção

Exemplo do conteúdo de .env.dev:

APP_ENV=dev
DB_HOST=localhost
DB_NAME=meu_app_dev
DB_USER=dev_user
DB_PASS=senha_segura_dev
API_KEY=teste123

Exemplo de .env.production:

APP_ENV=production
DB_HOST=prod-banco.gehost.com.br
DB_NAME=meu_app_prod
DB_USER=prod_user
DB_PASS=senha_segura_producao_real
API_KEY=chave_real_gerada_pelo_serviço

Dica Sensei: Nunca commita arquivos como .env no Git. Use um .gitignore para ignorar todos os arquivos com extensão .env. Assim, suas senhas não vão parar no GitHub!

Carregue as variáveis no momento do início do app

Seu app precisa saber qual arquivo usar. Para isso, você pode usar um script de inicialização ou configurar o servidor para carregar o arquivo correto com base em um parâmetro.

Exemplo com um script em Bash (start.sh):

#!/bin/bash
ENV=${1:-dev}  # Padrão: dev, se não for informado
source .env.$ENV
# Agora o app pode usar as variáveis carregadas
php app.php

Para rodar:

chmod +x start.sh
./start.sh staging

Pronto! O app agora carrega as configurações do ambiente staging.

Use o sistema de ambiente no seu código

Seu código pode verificar qual ambiente está rodando e ajustar comportamentos. Por exemplo, em PHP:

$env = getenv('APP_ENV') ?: 'dev';
if ($env === 'production') {
    error_reporting(0); // Não exibir erros no producao
} else {
    error_reporting(E_ALL); // Mostrar erros em dev
}

Segurança e boas práticas

• Use .env apenas em servidores que você controla — nunca em repositórios públicos.
• Evite usar arquivos com permissão de leitura por todos. Configure com chmod 600 .env.dev.
• Use um sistema de gerenciamento de configuração (como dotenv em PHP ou Node.js) para facilitar o carregamento.
• Teste sempre em staging antes de subir para produção.

Atenção, Sensei: Seu projeto é seu bem mais valioso. Proteja-o com variáveis de ambiente, controle de acesso e boas práticas. O que é seguro hoje, pode ser um problema amanhã se não cuidar.

Conclusão

Configurar variáveis de ambiente por ambiente não é difícil — é só organização. Com esse método, você pode:

• Desenvolver com segurança, sem risco de confusão.
• Testar mudanças em staging antes de afetar o público.
• Manter a produção estável e protegida.

Na GeHost, você tem o poder de fazer isso com total liberdade, sem depender de planos caros ou ferramentas complexas. É só usar o VPS com responsabilidade e inteligência.

Se tiver dúvidas, entre em contato com nosso suporte — estamos aqui para te ajudar. E lembre-se: o melhor código é aquele que é testado, protegido e organizado.

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