Como usar environment variables no arquivo .env do projeto Print

Como usar environment variables no arquivo .env do projeto (SSH & Avançado)

Olá, querido(a) aluno(a) da GeHost! 👋 Seja bem-vindo(a) ao nosso guia prático e carinhoso sobre como usar variáveis de ambiente no arquivo .env — um dos pilares mais importantes para manter seus projetos seguros, flexíveis e fáceis de configurar em diferentes ambientes.

Se você já se perguntou como manter senhas, chaves de API ou URLs de banco de dados fora do código-fonte, este é o seu momento! Vamos juntos, passo a passo, dominar essa técnica com calma, clareza e um toque de sabedoria — como um verdadeiro Sensei da hospedagem. 🌿

O que são environment variables?

Imagine que você tem um projeto que precisa se conectar a um banco de dados. Em vez de colocar o nome do usuário e a senha diretamente no código, você guarda essas informações em um arquivo especial chamado .env. Esse arquivo não é acessível pela internet e só é lido pelo seu sistema quando o projeto está em execução.

Dica do Sensei: Nunca, em hipótese alguma, coloque senhas, chaves de API ou dados sensíveis no código-fonte. O .env é o seu escudo de segurança.

Passo a passo: Como configurar o .env no seu projeto

1. Entre no Gerenciador de Arquivos do cPanel

   Logue no seu painel de controle (cPanel) e clique em Gerenciador de Arquivos no grupo Arquivos.

   

2. Navegue até a pasta do seu projeto

   Na árvore de pastas, vá até a pasta onde seu projeto está hospedado. Geralmente, essa pasta é public_html ou uma subpasta dentro dela (como meu-projeto).

3. Crie o arquivo .env

   Na pasta do seu projeto, clique em Novo Arquivo e digite o nome: .env. Atenção: o nome deve começar com um ponto (.) e não pode ter extensão.

4. Adicione suas variáveis de ambiente

   Abra o arquivo .env com o editor de texto do cPanel e adicione as variáveis no formato CHAVE=VALOR. Exemplo:

   DB_HOST=localhost
   DB_NAME=meu_banco
   DB_USER=usuario_db
   DB_PASS=senha_segura123
   API_KEY=chave_api_abc123xyz
   APP_ENV=production

   Salve as alterações.

5. Configure seu sistema para ler o .env

   Isso depende do seu framework ou linguagem. Por exemplo:

   • Node.js (Express, Nest, etc.): Use o pacote dotenv. Instale com npm install dotenv e no início do seu código, adicione require('dotenv').config();.
   • PHP (Laravel, Symfony, etc.): O framework geralmente já lê o .env automaticamente. Verifique se o arquivo está na raiz do projeto.
   • Python (Django, Flask, etc.): Use python-dotenv e importe com from dotenv import load_dotenv.

   Importante: O arquivo .env NÃO deve ser enviado ao GitHub ou compartilhado com ninguém. Use o .gitignore para protegê-lo.

6. Teste sua configuração

   Reinicie seu servidor ou execute seu projeto e verifique se as variáveis estão sendo lidas corretamente. Se algo der errado, verifique se o nome do arquivo está correto, se o caminho está certo e se o pacote necessário está instalado.

Regras de ouro para usar .env com segurança

• Nunca comite o .env no Git: Adicione .env ao arquivo .gitignore.
• Use nomes claros: Ex: DB_PASSWORD é melhor que senha1.
• Evite valores fixos: Use variáveis para ambientes diferentes (desenvolvimento, produção).
• Proteja o acesso: O arquivo .env deve estar fora da pasta pública (não em public_html se possível).

Palavra final do Sensei: O .env é como um segredo entre você e o seu sistema. Use com sabedoria, respeito e segurança. Quando você domina isso, você não está só programando — você está engenhando com propósito.

Se precisar de ajuda, não hesite em entrar em contato com nosso suporte. Estamos aqui para te ajudar a crescer, com carinho e tecnologia. 💚