Como usar variáveis de ambiente no PHP na GeHost
Olá, querido(a) cliente! Seja bem-vindo(a) ao seu guia de mão na massa, com carinho e paciência, como se fosse um papo entre amigos. Hoje vamos aprender juntos como usar variáveis de ambiente no PHP — uma ferramenta poderosa para manter suas configurações seguras e flexíveis, especialmente quando você trabalha com aplicativos como WordPress, Laravel, ou qualquer outro sistema em PHP.
Imagine que você tem uma senha de banco de dados, uma chave de API ou uma URL de ambiente. Em vez de deixar essas informações expostas diretamente no código (o que é perigoso!), você as armazena em variáveis de ambiente — como se fosse um segredo guardado em um cofrinho, só acessível quando necessário.
Na GeHost, isso é possível com o PHP-FPM + .env e o painel de controle cPanel. Vamos lá, passo a passo, com calma e clareza.
Passo 1: Acesse o cPanel
Primeiro, faça login no seu painel de controle da GeHost. Se você já tem acesso, é só digitar seu nome de usuário e senha.
Passo 2: Acesse o Gerenciador de Arquivos
Na tela inicial do cPanel, procure pela ferramenta Gerenciador de Arquivos (File Manager). Ela está no grupo "Arquivos". Clique nela.
Passo 3: Navegue até a pasta pública
No Gerenciador de Arquivos, selecione a opção Public_html (ou o nome da sua pasta raiz, como www, site, etc.). É aqui que seu site está hospedado.
Passo 4: Crie ou edite o arquivo .env
Se você já tem um arquivo chamado .env no diretório public_html, ótimo! Se não, crie um novo arquivo com esse nome.
- Na interface do Gerenciador de Arquivos, clique em Novo Arquivo.
- Digite
.envcomo nome. - Clique em Salvar.
Abra o arquivo .env para editar. Adicione suas variáveis assim:
DB_HOST=localhost
DB_NAME=meu_banco
DB_USER=usuario_db
DB_PASS=senha_segura
APP_ENV=production
Essas são apenas exemplos. Substitua pelos valores reais do seu projeto. Lembre-se: nunca coloque senhas reais no código fonte!
Passo 5: Instale uma biblioteca para ler o .env (opcional, mas recomendado)
Para que o PHP leia essas variáveis automaticamente, você precisa de uma biblioteca como vlucas/phpdotenv. Ela é muito simples e amplamente usada.
Se você está usando um framework como Laravel, Symfony ou mesmo um projeto personalizado, o ideal é instalar essa biblioteca via Composer. Mas se você está apenas começando, aqui vai um jeito simples:
Adicione este código no início do seu arquivo PHP principal (como index.php ou config.php):
// Carrega as variáveis do .env
if (file_exists(__DIR__ . '/.env')) {
foreach (file(__DIR__ . '/.env', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES) as $line) {
if (strpos($line, '=') !== false && strpos($line, '#') !== 0) {
$parts = explode('=', $line, 2);
putenv(trim($parts[0]) . '=' . trim($parts[1]));
}
}
}
Esse trecho de código lê o arquivo .env e torna as variáveis disponíveis no PHP via getenv() ou $_ENV.
Passo 6: Use as variáveis no seu código
Agora, no seu código PHP, você pode usar as variáveis assim:
$host = getenv('DB_HOST');
$user = getenv('DB_USER');
$pass = getenv('DB_PASS');
$name = getenv('DB_NAME');
Pronto! Seu sistema está usando configurações externas, seguras e fáceis de alterar — sem tocar no código principal.
Dica sensata (do Sensei da GeHost)
⚠️ Nunca comite o arquivo .env no GitHub ou em qualquer repositório público! Ele contém dados sensíveis. Use um .gitignore para excluí-lo do controle de versão.
Conclusão
Usar variáveis de ambiente no PHP é uma prática profissional e segura. Na GeHost, com o cPanel e o Gerenciador de Arquivos, você tem tudo o que precisa para fazer isso com tranquilidade.
Se tiver dúvidas, problemas ou quiser um exemplo completo, é só chamar nossa equipe de suporte — estamos aqui com um sorriso e um café (virtual, claro!).
Com carinho,
Sensei da GeHost