Pular para o conteúdo
Documentação

Meus domínios e PHP-FPM

Consulte seus domínios, versão do PHP e pasta pública, e recarregue o PHP-FPM para aplicar mudanças e limpar o OPcache.

R Regis Manze 20/11/2026 6 min de leitura

A tela Meus Dominios mostra os domínios da sua conta, permite definir variáveis de ambiente por domínio e recarregar o PHP-FPM, o serviço que executa o PHP dos seus sites.

Lista de domínios

Para cada domínio, a tabela mostra:

Coluna O que é
Dominio Endereço do site. Abaixo dele aparecem os apelidos (aliases), se houver, como www.exemplo.com.br
PHP Versão do PHP usada pelo domínio, por exemplo PHP 8.3
Document Root Pasta pública: a pasta que o servidor entrega quando alguém acessa o domínio
Status Ativo (site no ar) ou Inativo (desligado pelo administrador)
Acoes Botão Arquivos, que abre o gerenciador de arquivos direto na pasta do domínio, e, nos sites PHP, botão Variáveis (veja abaixo)

O quadro Informacoes, no fim da tela, lembra que:

  • sua pasta de sites é /home/usuario/public_html/;
  • o acesso FTP/SSH usa o mesmo usuário e senha do painel;
  • a versão do PHP é gerenciada pelo administrador.

O que só o administrador muda

Você não altera estes itens pelo painel do cliente. Peça ao seu provedor:

  • incluir ou remover domínios e apelidos;
  • trocar a versão do PHP;
  • mudar a pasta pública (por exemplo, para public_html/public em um projeto Laravel);
  • ativar ou desativar um domínio.

Variáveis de ambiente do domínio

Cada site PHP pode ter variáveis de ambiente próprias, que o PHP lê com getenv('CHAVE') ou $_SERVER['CHAVE']. O painel grava as variáveis na configuração do servidor web para aquele domínio.

  1. Na linha do domínio, clique em Variáveis, ao lado de Arquivos. Se o domínio já tem variáveis, o botão mostra a quantidade, por exemplo "Variáveis (2)".

  2. Na janela, escreva uma variável por linha, no formato CHAVE=valor:

    # loja principal
    MAGE_RUN_CODE=base
    MAGE_RUN_TYPE=website
    

    Linhas que começam com # são comentários. Também dá para colar linhas no formato SetEnv CHAVE valor.

  3. Clique em Salvar e recarregar. O servidor web é recarregado e a variável já vale para as próximas requisições.

Para remover todas as variáveis, apague o texto da caixa e salve.

As variáveis valem por domínio: dois domínios que apontam para a mesma pasta podem ter valores diferentes. É o caso típico do Magento com várias lojas no mesmo código, por exemplo:

Domínio Variáveis
loja1.exemplo.com.br MAGE_RUN_CODE=base e MAGE_RUN_TYPE=website
loja2.exemplo.com.br MAGE_RUN_CODE=loja2 e MAGE_RUN_TYPE=website

Regras:

  • nome com letras, números e _, sem começar com número, até 64 caracteres;
  • valor com até 1024 caracteres, sem aspas duplas ("), barra invertida (\), $ ou quebra de linha;
  • até 50 variáveis por domínio;
  • nomes reservados do servidor web e do PHP são recusados, como PHP_VALUE, PHP_ADMIN_VALUE, HTTPS, PATH e os que começam com HTTP_, SERVER_, REMOTE_, REQUEST_, SCRIPT_ ou DOCUMENT_.

Se o servidor web recusar a nova configuração, nada muda: a configuração anterior do domínio continua valendo e aparece a mensagem "O servidor web recusou a configuracao; nada foi alterado.", com o erro.

As variáveis continuam valendo quando o administrador troca a versão do PHP, os apelidos ou a pasta pública do domínio.

Atenção: o arquivo .env da tela Associacoes é outra coisa. Ele é lido pela própria aplicação (Laravel, dotenv) e não vira variável do PHP. Se o seu código usa getenv() ou $_SERVER, cadastre a variável aqui. Veja Associações e arquivo .env.

Dica: evite guardar senhas nessas variáveis. Os valores ficam visíveis para o administrador e para integrações com o token de escrita da API do painel (o token de leitura vê só os nomes). Para senhas da aplicação, prefira o .env.

O botão Variáveis não aparece em apps Node.js (que têm variáveis próprias, configuradas pelo administrador) nem em domínios de redirecionamento.

Quadro PHP-FPM

O quadro PHP-FPM lista cada versão do PHP usada pelos seus domínios, com o estado do serviço:

  • Ativo: o PHP está rodando normalmente;
  • outro valor (por exemplo, failed ou inactive): o serviço tem problema. Avise o administrador.

Recarregar o PHP-FPM (Reload)

Use o Reload depois de publicar uma nova versão do site, quando as mudanças nos arquivos PHP não aparecem. O reload:

  • recarrega a configuração do PHP;
  • limpa o OPcache, o cache de código compilado do PHP;
  • não derruba as conexões em andamento.

Passo a passo:

  1. Abra Meus Dominios.
  2. No quadro PHP-FPM, encontre a versão usada pelo seu site.
  3. Clique em Reload.
  4. Confirme em OK na pergunta "Recarregar (reload) PHP 8.3-FPM?".
  5. Aguarde a mensagem "PHP 8.3-FPM recarregado (reload) com sucesso!".

O reload vale para todos os sites do servidor que usam aquela versão do PHP. Por isso, cada cliente pode recarregar no máximo uma vez a cada 2 minutos. Antes disso, aparece "Aguarde Ns para recarregar de novo.".

Dica: depois de um deploy de Laravel ou Magento, rode primeiro os comandos de cache da aplicação (por exemplo php artisan optimize ou bin/magento cache:flush) e então faça o Reload para limpar o OPcache.

Ver o estado detalhado (Status)

  1. Clique em Status na linha da versão do PHP.
  2. Abaixo da tabela aparece o resultado, com:
    • Estado do serviço (por exemplo, active);
    • Processos do seu pool: quantos processos PHP estão atendendo seus sites agora;
    • as últimas linhas do registro do serviço.

Se Processos do seu pool estiver sempre no máximo e o site lento, seu site pode estar recebendo mais acessos do que o pool comporta. Fale com o administrador para avaliar o ajuste.

Problemas comuns

Sintoma O que verificar
Alterei um arquivo PHP e nada mudou Faça o Reload do PHP-FPM e limpe o cache da aplicação
"Aguarde Ns para recarregar de novo." Já houve um reload há menos de 2 minutos. Espere o tempo indicado
Erro 502 ou 503 no site Veja o Status do PHP-FPM e o log de erro em Meus Logs
Site mostra a lista de arquivos ou erro 403 O Document Root pode estar apontando para a pasta errada. Confira com o administrador
Status "Inativo" no domínio O domínio foi desativado. Fale com o administrador
getenv('CHAVE') retorna false A variável está só no .env. Cadastre-a em Variáveis, na linha do domínio
Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!