Como configurar variáveis de ambiente diferentes para produção e desenvolvimento

Como configurar variáveis de ambiente diferentes para produção e desenvolvimento

Olá, querido(a) desenvolvedor(a) e amante de tecnologia! Seja muito bem-vindo(a) ao seu novo guia de bordo na GeHost, onde aprendemos juntos, com calma, com carinho e com a certeza de que cada passo é uma conquista.

Se você está criando um site ou aplicativo, provavelmente já se perguntou: "Como faço meu sistema usar configurações diferentes no ambiente de desenvolvimento (meu computador) e no ambiente de produção (o site que está no ar)?"

A resposta é simples: variáveis de ambiente. Elas são como "comandos secretos" que seu sistema lê para saber como se comportar — por exemplo, se deve conectar a um banco de dados de teste ou ao real, se deve mostrar erros detalhados ou não, e assim por diante.

Na GeHost, você pode configurar essas variáveis de forma segura e eficiente. Vamos aprender passo a passo, com calma, como fazer isso no seu site hospedado.

Passo 1: Entenda o que são variáveis de ambiente

Imagine que seu site é uma pessoa. No desenvolvimento, ele está em casa, com tudo liberado — pode ver erros, testar tudo. Na produção, ele está no trabalho: discreto, seguro, sem mostrar detalhes.

As variáveis de ambiente são como "modos de operação" que você define para o sistema. Elas não ficam no código, mas são carregadas pelo servidor quando o site roda.

Exemplo:

• DEVELOPMENT = true → mostra erros, usa banco de teste
• PRODUCTION = true → oculta erros, usa banco real

Passo 2: Acesse o painel do cPanel

Para começar, faça login no seu painel do cliente:

Insira seu usuário (geralmente seu domínio ou nome de conta) e a senha. Após o login, você verá o painel principal.

Passo 3: Acesse o Gerenciador de Arquivos

No painel do cPanel, clique em Arquivos e depois em Gerenciador de Arquivos.

Selecione a pasta public_html (ou a pasta do seu site) e clique em Ir.

Passo 4: Crie ou edite o arquivo .env

O arquivo .env é onde você armazena suas variáveis de ambiente. Ele não deve ser acessado diretamente pelo navegador — é um arquivo interno.

Se ainda não tiver um arquivo .env, clique em Novo Arquivo no Gerenciador de Arquivos.

Digite o nome: .env (com o ponto na frente).

Abra o arquivo e insira as variáveis. Exemplo:

APP_ENV=development
DB_HOST=localhost
DB_NAME=meu_site_dev
DB_USER=dev_user
DB_PASS=senha123
DEBUG=true

Para a produção, troque para:

APP_ENV=production
DB_HOST=localhost
DB_NAME=meu_site_prod
DB_USER=prod_user
DB_PASS=senha_segura
DEBUG=false

Dica do Sensei: Nunca deixe senhas ou chaves sensíveis no código fonte. O arquivo .env é o lugar certo — ele fica fora do acesso público, desde que protegido.

Passo 5: Use o arquivo .env no seu código

Seu sistema (PHP, Node.js, Python, etc.) precisa saber ler esse arquivo. A maioria dos frameworks (como Laravel, Express, Django) já vem com suporte nativo.

Exemplo em PHP (usando dotenv):

// Carrega as variáveis do .env
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->load();

// Usa as variáveis
if (getenv('APP_ENV') === 'development') {
    error_reporting(E_ALL);
    ini_set('display_errors', '1');
} else {
    error_reporting(0);
    ini_set('display_errors', '0');
}

Passo 6: Evite erros comuns

Alguns cuidados importantes:

• Nunca comite o arquivo .env no Git — ele pode conter senhas reais.
• Use o .gitignore para bloquear o arquivo.
• Não coloque o .env na raiz pública do site (como public_html) — ele já está lá, mas o acesso deve ser bloqueado.
• Se o seu sistema não reconhecer o arquivo, verifique se ele está no caminho certo e com permissão de leitura.

Passo 7: Teste com segurança

Depois de configurar, teste seu site em modo de desenvolvimento. Verifique se os erros aparecem (se for o caso) e se o banco de dados está conectado corretamente.

Depois, mude as variáveis para production e verifique se o site está estável, sem erros visíveis.

Importante: Sempre faça testes em um ambiente de homologação (se tiver) antes de mudar para produção no servidor real.

Conclusão: Você está no caminho certo

Configurar variáveis de ambiente diferentes para desenvolvimento e produção é um hábito profissional que faz toda a diferença. Você está protegendo seu código, evitando erros no ar e garantindo que seu sistema funcione como deveria — em cada ambiente.

Se precisar de ajuda, não hesite em entrar em contato com nosso suporte. Estamos aqui para te ajudar, com carinho, com paciência e com a certeza de que você está aprendendo.

Com amor e tecnologia,
Sensei da GeHost

GeHost — hospedagem que cuida de você, como se fosse um amigo. Grupo: G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04).