Como Configurar Variáveis de Ambiente no cPanel – Guia Passo a Passo para Iniciantes
Olá, viajante da web! 😊 Se você está aqui, provavelmente quer dar um passo a mais na gestão do seu site ou aplicação — talvez esteja trabalhando com um sistema que precisa de configurações personalizadas, como chaves de API, URLs de banco de dados ou outros dados sensíveis. Aqui na GeHost, acreditamos que todo mundo pode dominar o básico do servidor, mesmo sem ser técnico. E hoje, vamos aprender juntos como configurar variáveis de ambiente no cPanel — de forma simples, segura e com um toque de calma.
Dica do Sensei: Variáveis de ambiente são como "segredos" que seu site ou aplicação usa para funcionar. Elas não ficam visíveis no código, mas são lidas em tempo real. É um jeito seguro de guardar informações importantes sem expor elas no código-fonte.
Passo 1: Acesse o cPanel
Primeiro, vamos entrar no painel de controle do seu servidor. Abra o navegador e vá até o endereço do seu cPanel (geralmente seu-dominio.com.br/cpanel ou cpanel.seu-dominio.com.br).
Digite seu usuário (geralmente o nome de domínio ou uma combinação com ele) e sua senha. Clique em Log in.
Passo 2: Encontre a Ferramenta "PHP Config" ou "MultiPHP Manager"
Depois de logado, você estará na tela principal do cPanel. Procure no menu (geralmente na seção Software) por uma das seguintes opções:
- MultiPHP Manager
- PHP Config (pode estar em "Extratos" ou "PHP")
Se você não encontrar essas opções, não se preocupe — o cPanel pode ter um nome diferente dependendo da versão. Mas fique tranquilo: a ideia é a mesma. Vamos usar o MultiPHP Manager porque é o mais comum.
Passo 3: Selecione o Domínio ou Pasta do Projeto
No MultiPHP Manager, você verá uma lista de domínios ou pastas onde seu site está hospedado. Selecione o domínio que você quer configurar (geralmente o principal, como seu-dominio.com.br).
Depois de selecionar, você verá uma lista de opções de PHP e um botão chamado “Configure PHP” ou “Editar Variáveis”. Clique nele.
Passo 4: Acesse as Variáveis de Ambiente (PHP Settings)
Na nova tela, procure por uma opção chamada:
- Environment Variables
- Ou PHP Settings → Environment Variables
Se não encontrar, verifique se o seu plano de hospedagem permite esse recurso. Na GeHost, todas as contas têm acesso a variáveis de ambiente em ambientes PHP.
Passo 5: Adicione Sua Variável de Ambiente
Agora vem a parte mágica! Você vai ver um campo onde pode adicionar novas variáveis. Cada uma tem dois campos:
- Nome da variável (ex:
DB_HOST,API_KEY,APP_ENV) - Valor (ex:
localhost,abc123xyz,production)
Exemplo prático:
- Nome:
APP_ENV - Valor:
production
Depois de preencher, clique em Adicionar ou Salvar.
Atenção do Sensei: Nunca coloque senhas, chaves ou dados sensíveis diretamente no código. Use variáveis de ambiente para manter tudo seguro!
Passo 6: Teste a Configuração
Para garantir que tudo está funcionando, crie um arquivo temporário chamado info.php dentro da pasta public_html (usando o Gerenciador de Arquivos).
Coloque este conteúdo nele:
<?php phpinfo(); ?>Salve e abra o arquivo no navegador (ex: seu-dominio.com.br/info.php). Procure por "Environment Variables" na página. Você deverá ver as variáveis que adicionou.
Dica Final do Sensei
As variáveis de ambiente são como um cofrinho secreto no seu servidor. Use-as com sabedoria: para chaves, URLs de banco de dados, ambientes (desenvolvimento, produção), e qualquer dado que você não queira expor no código.
Se precisar de ajuda, basta chamar o nosso suporte — estamos aqui para te ajudar, sempre. 💚
Parabéns! Você acabou de dominar uma parte essencial do DevOps no cPanel. 🎉
