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

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

Olá, querido(a) desenvolvedor(a)! 🌟 Seja bem-vindo(a) ao seu novo passo rumo a um desenvolvimento mais seguro, organizado e profissional. Hoje, vamos aprender como usar variáveis de ambiente de forma inteligente — especialmente para manter sua homologação (teste) e sua produção (site no ar) separadas, seguras e fáceis de gerenciar.

Dica do Sensei: Variáveis de ambiente são como "segredos" do seu sistema — elas guardam dados sensíveis (como senhas, chaves de API, URLs de banco) sem expô-los no código. Separar esses segredos entre homologação e produção evita que você acabe testando no site real por engano!

Por que fazer isso?

Imagine que você está testando um novo recurso. Se a sua homologação usar a mesma configuração da produção (por exemplo, o mesmo banco de dados ou a mesma chave de API), um erro pode afetar seu site real. Com variáveis de ambiente separadas, você evita esse risco. É como ter dois carros: um para testes e outro para o dia a dia.

Passo a passo: configurando variáveis para homologação e produção

1. Entre no cPanel com suas credenciais. Você já sabe, né? É só acessar o painel de controle do seu site.

   

2. Na tela principal do cPanel, procure pela ferramenta “Gerenciador de Arquivos” (File Manager). Ela está no grupo “Arquivos”.

   

3. No Gerenciador de Arquivos, navegue até a pasta onde seu projeto está hospedado. Normalmente, é a pasta public_html (ou um subdiretório como public_html/projeto).

4. Crie uma nova pasta chamada .env dentro da pasta do seu projeto. Se já existir, não se preocupe — vamos editar.

   Se você não vir arquivos ocultos (como .env), clique no botão “Configurações” no canto superior direito do Gerenciador de Arquivos e marque a opção “Mostrar arquivos ocultos”.

5. Dentro da pasta .env, crie dois arquivos separados:

   • .env.homologacao — para a versão de teste.
   • .env.producao — para o site no ar.

   Para criar um novo arquivo, clique com o botão direito na pasta .env e escolha “Criar novo arquivo”. Nomeie-o corretamente.

6. Abra o arquivo .env.homologacao e adicione as variáveis de ambiente para o ambiente de teste. Exemplo:

   APP_ENV=homologacao
   DB_HOST=localhost
   DB_NAME=meu_projeto_homolog
   DB_USER=homolog_user
   DB_PASS=senha123
   API_KEY=teste-123456

7. Abra o arquivo .env.producao e adicione as variáveis para o ambiente real. Exemplo:

   APP_ENV=producao
   DB_HOST=localhost
   DB_NAME=meu_projeto_prod
   DB_USER=prod_user
   DB_PASS=senha-segura-gerada
   API_KEY=chave-real-789012

8. Depois de salvar os arquivos, você precisa configurar seu sistema para carregar o arquivo correto, dependendo do ambiente.

   Isso geralmente é feito no código do seu sistema (por exemplo, em um arquivo de configuração principal). Veja um exemplo em PHP:

   // No arquivo de configuração principal (ex: config.php)
   $env = $_SERVER['APP_ENV'] ?? 'homologacao';
   
   if ($env === 'producao') {
       $envFile = '.env.producao';
   } else {
       $envFile = '.env.homologacao';
   }
   
   // Carrega as variáveis do arquivo
   if (file_exists($envFile)) {
       $lines = file($envFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
       foreach ($lines as $line) {
           if (strpos($line, '=') !== false) {
               list($key, $value) = explode('=', $line, 2);
               $_ENV[trim($key)] = trim($value);
           }
       }
   }

   Seu sistema vai carregar o arquivo certo com base na variável APP_ENV.

9. Para mudar entre ambientes, basta definir a variável APP_ENV no servidor. Isso pode ser feito de várias formas:

   • Em um arquivo .htaccess (para sites em PHP):

   RewriteEngine On
   SetEnv APP_ENV homologacao

   Substitua homologacao por producao quando quiser mudar.

Dica do Sensei: use o .gitignore!

Evite enviar arquivos como .env para o GitHub. Adicione esta linha no seu arquivo .gitignore:

.env*

Assim, seus segredos ficam seguros e não vão parar no repositório público.

Resumo do que você aprendeu hoje

• Você criou arquivos de variáveis de ambiente separados para homologação e produção.
• Usou o .htaccess para definir qual ambiente está ativo.
• Protegeu suas senhas e chaves, evitando que caiam no repositório.
• Está pronto para desenvolver com segurança e confiança!

Parabéns, aluno(a) da GeHost! 🎉 Você está cada vez mais próximo de ser um verdadeiro mestre do desenvolvimento. Se precisar de ajuda com o seu código ou tiver dúvidas, estamos aqui — como sempre, com um sorriso e um café quentinho virtual. 💬☕