Todo projeto acaba precisando de valores que não devem ficar à vista: a chave de uma API, a senha do banco, o endereço de um serviço. Escrever isso direto no código é um erro comum, porque quem vê o código vê o segredo. As variáveis de ambiente resolvem esse problema.
O que são
Uma variável de ambiente é um par de nome e valor guardado no ambiente onde o programa roda, não dentro do código. O programa pergunta ao sistema pelo valor no momento em que precisa dele.
Isso traz duas vantagens:
- os segredos não entram no repositório;
- você pode usar valores diferentes em cada ambiente, como teste no seu computador e produção no servidor, sem mudar o código.
O arquivo .env na prática
Em muitos projetos, os valores ficam em um arquivo chamado .env na pasta do projeto, com uma linha por variável. Um exemplo de conteúdo seria o nome da variável, um sinal de igual e o valor. Uma biblioteca do seu ambiente de programação carrega esse arquivo ao iniciar, e o código lê as variáveis pelo nome. Os detalhes mudam conforme a linguagem, então consulte a documentação do que você usa.
Passo a passo básico:
- Crie o arquivo .env na raiz do projeto.
- Escreva as variáveis, uma por linha.
- Instale a biblioteca que carrega o arquivo na sua linguagem, se ela não for nativa.
- No código, leia o valor pelo nome da variável, nunca pelo valor em si.
- Adicione o .env ao arquivo .gitignore antes do primeiro commit.
Erros que causam vazamentos
- Subir o .env para o repositório por esquecer o .gitignore. Mesmo apagando depois, o segredo continua no histórico.
- Colocar a chave em um código que roda no navegador, onde qualquer visitante consegue vê-la.
- Compartilhar o arquivo por mensagem ou captura de tela.
- Usar a mesma chave em todos os projetos.
Se uma chave já foi exposta, o caminho é revogá-la e criar outra. O artigo Subi uma chave de API ou senha no GitHub: o que fazer agora traz o passo a passo.
Em servidores e hospedagens
Serviços de hospedagem costumam ter uma área própria para cadastrar variáveis, sem precisar de arquivo no servidor. O nome do menu varia entre plataformas. Em projetos maiores, vale usar um gerenciador de segredos, que controla quem acessa o quê e registra o uso.
Para entender melhor o contexto, veja O que é API e para que serve, explicado sem complicação e Git e GitHub para iniciantes: o que são e como usar.