Como usar variáveis de ambiente no servidor Print

Como usar variáveis de ambiente no servidor

Opa! Aqui é a Sensei da GeHost 🥋 Tá achando que "variáveis de ambiente" é coisa de bruxa? Relaxa, é bem mais simples do que parece. Vou te ensinar como usar esse superpoder do seu servidor de forma tranquila.

O que é variável de ambiente?

Pensa em uma variável de ambiente como um "recado" que você deixa no seu servidor. Seu programa lê esse recado e usa a informação. É como colocar um post-it no computador dizendo "use essa senha para conectar no banco de dados".

Ao invés de escrever a senha DENTRO do código (perigoso!), você coloca a senha numa variável de ambiente e o código vai buscar lá.

💡 Por que usar? Segurança! Você não quer deixar senhas e chaves confidenciais espalhadas no código onde qualquer um pode ver. Variáveis de ambiente ficam separadas, seguras.

Onde as variáveis de ambiente vivem?

No seu servidor hospedado na GeHost, as variáveis ficam geralmente em um arquivo chamado .env (arquivo oculto, começa com ponto) ou são definidas diretamente no shell.

Como criar e usar variáveis de ambiente

Opção 1: Via Arquivo .env (Recomendado para iniciantes)

1. Acesse seu servidor via SSH ou pelo Gerenciador de Arquivos do cPanel.
2. Navegue até a pasta raiz do seu site (geralmente public_html ou a pasta do seu projeto).
3. Crie um arquivo novo chamado .env (com o ponto na frente).
4. Abra o arquivo e adicione suas variáveis no formato: NOME_DA_VARIAVEL=valor

Exemplo de arquivo .env:

DB_HOST=localhost
DB_USER=seu_usuario
DB_PASSWORD=sua_senha_secreta
DB_NAME=seu_banco
APP_ENV=production

Pronto! Seu programa (PHP, Node, Python, etc.) agora consegue acessar essas variáveis.

Opção 2: Via SSH (Para os mais corajosos 🔥)

1. Conecte-se ao seu servidor via SSH usando um cliente como PuTTY, Terminal ou WinSCP.
2. Navegue até a pasta do seu projeto: cd public_html
3. Crie o arquivo .env: nano .env
4. Adicione suas variáveis (mesma sintaxe acima).
5. Salve o arquivo (pressione Ctrl + O, depois Enter, depois Ctrl + X no nano).
6. Pronto! O servidor já "vê" as variáveis.

Como o seu código acessa as variáveis?

Depende da linguagem que você usa. Aqui estão os exemplos mais comuns:

PHP:

$db_password = getenv('DB_PASSWORD');
$db_user = $_ENV['DB_USER'];

Node.js:

const dbPassword = process.env.DB_PASSWORD;
const appEnv = process.env.APP_ENV;

Python:

import os
db_password = os.getenv('DB_PASSWORD')

🔒 Dicas de segurança essenciais

• Nunca comite .env no Git. Adicione .env ao seu .gitignore.
• Proteja o arquivo .env. Use permissões restritas (chmod 600) para que só o proprietário possa ler.
• Não coloque dados reais no código. Sempre use variáveis de ambiente para senhas e chaves de API.
• Crie um arquivo .env.example. Deixe um modelo (sem dados reais) para outros devs saberem quais variáveis precisam.

Deu ruim? Troubleshooting 🚨

P: "Defini a variável mas o programa não tá vendo"

R: Pode ser que o servidor não tenha recarregado. Tente reiniciar a aplicação ou fazer um upload novo. Se usar PHP-FPM, às vezes é preciso reiniciar o serviço.

P: "Tá dando erro de permissão"

R: Verifique as permissões do arquivo .env. Via SSH, rode: chmod 600 .env

P: "Posso usar .env em produção?"

R: Sim, é a forma recomendada! Mas sempre proteja o arquivo com permissões rígidas e nunca o deixe acessível publicamente.

Próximos passos

Agora que você já sabe o básico, explore bibliotecas que facilitam a leitura do .env (como phpdotenv para PHP, dotenv para Node.js). Elas automatizam o processo e deixam seu código mais limpo.

Dúvida? Abre um ticket com a gente — a Agent Neves (técnico) vem te ajudar! 🥋