Servidor & DevOps 9 visualizações

Como configurar variáveis de ambiente no cPanel para aplicações customizadas

Ver no WHMCS

Como Configurar Variáveis de Ambiente no cPanel para Aplicações Customizadas

Olá, querido(a) desenvolvedor(a) ou administrador(a) de site! Seja muito bem-vindo(a) ao nosso Sensei da GeHost — aqui, vamos te guiar com carinho, passo a passo, para que você configure variáveis de ambiente no cPanel, mesmo que esteja começando agora. 🌟

As variáveis de ambiente são como "segredos" que sua aplicação precisa para funcionar corretamente — por exemplo, senhas de banco de dados, chaves de API, URLs de ambiente (produção, homologação, etc.). Elas não ficam no código, mas são carregadas pelo servidor quando a aplicação roda. Isso torna seu projeto mais seguro e flexível.

Dica do Sensei: Nunca coloque senhas ou chaves diretamente no código-fonte. Use variáveis de ambiente sempre que possível!

Passo a Passo: Configurando Variáveis de Ambiente no cPanel

  1. Entre no cPanel

    Abra seu navegador e acesse o painel de controle da GeHost. Você pode fazer isso com o link que recebemos por e-mail ou pelo endereço padrão da sua conta.

    Tela de LOGIN do cPanel com campos Usuário e Senha e botão Log in
  2. Localize a ferramenta "PHP Variables" (ou "Env Variables")

    Uma vez logado, procure na seção “Software” ou “Programas” por uma ferramenta chamada “PHP Variables” ou “Env Variables”. Ela pode estar dentro do grupo "Advanced" ou "Developer Tools".

    Se não encontrar, use a barra de busca no cPanel e digite “env” ou “variáveis”.

  3. Clique em "PHP Variables" (ou "Env Variables")

    Após encontrar a ferramenta, clique nela. Você verá uma tela com campos para adicionar variáveis.

    Painel inicial (home) do cPanel com os grupos de ferramentas como E-mail, Arquivos, Programas, etc.
  4. Adicione suas variáveis

    Na tela de variáveis, você verá dois campos:

    • Nome: o nome da variável (ex: DB_HOST, API_KEY, ENVIRONMENT)
    • Valor: o valor que ela deve ter (ex: localhost, abc123xyz, production)

    Por exemplo:

    • Nome: DB_HOST
    • Valor: localhost

    Depois de preencher, clique em “Adicionar”.

  5. Salve as alterações

    Após adicionar todas as variáveis que sua aplicação precisa, clique em “Salvar” ou “Atualizar”. O cPanel salva automaticamente as configurações.

  6. Teste sua aplicação

    Reinicie sua aplicação (se necessário) e verifique se ela está lendo as variáveis corretamente. Se estiver tudo certo, seu site ou sistema funcionará com os dados corretos, sem expor senhas no código.

Exemplo Prático: Aplicação em PHP com Variáveis de Ambiente

Suponha que você tenha um arquivo config.php com este trecho:

$host = getenv('DB_HOST');
$user = getenv('DB_USER');
$pass = getenv('DB_PASS');

Se você configurou as variáveis no cPanel como:

  • DB_HOSTlocalhost
  • DB_USERmeu_usuario
  • DB_PASSminhasenha123

Seu script vai funcionar perfeitamente — e ninguém verá a senha no código!

Atenção do Sensei: Variáveis de ambiente só funcionam em ambientes que suportam getenv() ou $_ENV. Isso inclui PHP, Node.js, Python (com bibliotecas específicas), entre outros. Verifique a documentação da sua aplicação!

Pronto! Você está no caminho certo 🌱

Parabéns! Você acabou de dar um grande passo no mundo da segurança e organização de projetos. Com variáveis de ambiente, seu site fica mais seguro, mais flexível e mais profissional.

Se tiver dúvidas, basta chamar o nosso suporte — estamos aqui para te ajudar, sempre. 💬

Com carinho,
Seu Sensei da GeHost 🌿

Precisa de Ajuda?

Nossa equipe está pronta para resolver suas dúvidas.