Base de conhecimento

1000 perguntas frequentes, 500 tutoriais e vídeos explicativos. Aqui, você encontra apenas soluções!

Utilizar as variáveis de ambiente PHP

Atualização 22/10/2026

Este guia explica como usar as variáveis de ambiente PHP com os Serviços de Hospedagem Web que funcionam em php-fpm.

 

Introdução

  • As variáveis de ambiente PHP são variáveis de sistema usadas para armazenar informações de configuração, parâmetros de conexão ou dados relacionados a requisições HTTP.
  • Elas permitem separar a configuração sensível ou específica do ambiente do código-fonte do seu site.
  • Essas variáveis podem conter informações como modos de execução, chaves de API ou outros dados essenciais para o bom funcionamento dos seus scripts PHP.
  • Não há limite para o número de variáveis de ambiente, mas seus valores não podem conter aspas (simples ' ou duplas ").
    • Ao contrário dos arquivos .env tradicionais, onde os valores são frequentemente delimitados por aspas (por exemplo, VAR="valor"), os valores inseridos aqui não devem conter aspas (" ou ').
    • Se um valor contiver aspas (como alguns caminhos ou chaves do tipo MAIL_DKIM_PRIVATE_KEY_PATH), a atualização será rejeitada com o erro “O site não foi atualizado”.
    • Insira sempre o valor bruto diretamente.

 

Utilizar variáveis de ambiente

Para utilizar as variáveis de ambiente PHP:

  1. Defina as variáveis de ambiente PHP num ficheiro .htaccess:
    • SetEnv EXAMPLEVARIABLE hello
  2. No seu ficheiro PHP, chame a variável utilizando a função dedicada:
    • <?php echo getenv('EXAMPLEVARIABLE');

Neste exemplo, o resultado exibido na página será hello.

 

Aprofunde-se com as variáveis de ambiente

É possível configurar variáveis de ambiente diretamente no painel de controle para todo o seu site:

  1. Clique aqui para acessar o gerenciamento de hospedagens e sites no seu painel de controle Infomaniak (❓: ajuda).
  2. Clique em o nome do site em questão.
  3. Clique em Gerenciar as configurações avançadas:
  4. Clique na aba PHP / Apache:
  5. Mais abaixo na página, clique na seta ‍ para expandir a seção Variáveis de ambiente.
  6. Clique no ícone ‍ Adicionar.
  7. Insira a variável e o seu valor.
  8. Clique no botão para salvar:

Esta seção de perguntas frequentes foi útil?