Pular para o conteúdo
Documentação

Gerenciar domínios

Como trocar a versão do PHP, o template de rewrite, os aliases e o document root, editar o pool PHP-FPM, desativar e remover um domínio.

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

A tela Hospedagem > Dominios lista todos os sites do servidor e permite alterar cada um sem recriar.

A tabela de domínios

Coluna O que mostra
Dominio Nome principal e, abaixo, os aliases. O lápis ao lado edita os aliases.
Usuario Conta dona do site.
PHP Versão do PHP. Em app Node.js mostra o botão Node com a porta; em redirecionamento, Redirect.
Rewrite Template de rewrite. Em Node.js mostra o proxy; em redirecionamento, o código e o destino.
Document Root Pasta do site. O lápis ao lado altera a pasta.
Status Ativo ou Inativo.

Se o servidor web recusar a mudança

Toda alteração desta tela (trocar PHP, rewrite, aliases, document root ou variáveis) é testada pelo servidor web antes de valer. Se ele recusar a configuração nova, o domínio volta exatamente ao estado anterior e aparece "O servidor web recusou a configuracao; nada foi alterado.", com o erro. Assim, uma configuração inválida não fica gravada travando os próximos reloads.

Trocar a versão do PHP

  1. Na coluna PHP, escolha a nova versão na lista.
  2. A alteração é aplicada na hora.

O painel cria o pool PHP-FPM da conta na nova versão, se ainda não existir, e regrava o vhost.

Trocar o template de rewrite

  1. Na coluna Rewrite, escolha Generico, Magento 2 ou Laravel.
  2. A alteração é aplicada na hora.

O template só muda o comportamento no modo NGINX Only. Nos modos com Apache, o rewrite vem do .htaccess. Escolher Magento 2 também aplica os ajustes de PHP para Magento no pool da conta.

Editar aliases

  1. Clique no lápis ao lado do nome do domínio.
  2. Digite um alias por linha (ou separados por espaço ou vírgula). Aceita curinga: *.exemplo.com.br.
  3. Deixe vazio para remover todos.
  4. Clique em Salvar.

Atenção: o alias precisa apontar no DNS para o servidor. Se o domínio já tem certificado SSL, reemita o certificado para incluir os novos nomes. O painel avisa quando isso é necessário. A reemissão renova o mesmo certificado do domínio (o nome do certificado é sempre o do domínio principal).

Alterar o document root

  1. Clique no lápis ao lado do caminho, na coluna Document Root.
  2. Informe a nova pasta, relativa à home. Ex.: public_html/public.
  3. Clique em Salvar.

O caminho aceita só letras, números, ., _, - e /, sem espaços nem ... Caso contrário, aparece "Document root invalido: use letras, numeros, . _ - e / (sem espacos nem ..).". A mesma regra vale na criação, na API e na migração.

A pasta é criada se não existir. Os arquivos não são movidos: só o vhost passa a apontar para o novo lugar.

Editar o pool PHP-FPM

  1. Clique em Editar pool PHP-FPM (ícone de arquivo de código) na linha do domínio.
  2. Altere o conteúdo e clique em Salvar.

O painel testa a configuração antes de aplicar. Se o teste falhar, o pool anterior é mantido e a mensagem mostra o erro.

Atenção: o pool é um só por usuário e versão do PHP. Alterá-lo afeta todos os sites da conta que usam a mesma versão.

Dica: para dimensionar processos e memória, prefira a tela Tuning. Ao salvar, ela altera só as diretivas de tuning (pm.*, request_terminate_timeout e memory_limit) e preserva o resto das suas edições manuais.

Variáveis de ambiente do domínio

Cada site PHP pode ter variáveis de ambiente próprias, lidas pelo PHP com getenv('CHAVE') ou $_SERVER['CHAVE'].

  1. Clique no ícone { } na coluna de ações da linha do domínio. O ícone fica azul quando o domínio já tem variáveis.
  2. Na janela, escreva uma variável por linha, no formato CHAVE=valor. 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.

Para remover todas, apague o texto da caixa e salve.

O painel grava as variáveis no vhost do domínio e recarrega o servidor web:

Modo do servidor web O que vai no vhost
Apache e NGINX + Apache SetEnv CHAVE "valor" no vhost do Apache
NGINX Only fastcgi_param CHAVE "valor"; no vhost do NGINX

Se o servidor web recusar a nova configuração, nada muda: o vhost anterior volta e a mensagem mostra o erro. As variáveis são mantidas quando você troca o PHP, os aliases, o document root ou o template de rewrite.

As variáveis valem por domínio: vários domínios que apontam para a mesma pasta podem ter valores diferentes. Caso típico é o Magento com várias lojas no mesmo código:

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 são recusados: PHP_VALUE, PHP_ADMIN_VALUE, HTTPS, PATH, os que começam com HTTP_, SERVER_, REMOTE_, REQUEST_, SCRIPT_ ou DOCUMENT_ e outras variáveis do CGI.

Não vale para apps Node.js (que têm variáveis próprias, veja Apps Node.js) nem para domínios de redirecionamento. O cliente também edita as variáveis dos seus domínios, pelo botão Variáveis em Meus Dominios. Cada alteração fica registrada na Auditoria com a ação domain_env.

Atenção: o .env da tela Associacoes do cliente é lido pela aplicação (Laravel, dotenv) e não vira variável do PHP. Quem usa getenv() ou $_SERVER precisa das variáveis do domínio.

Dica: não guarde senhas nessas variáveis. Na API, o token de leitura vê só os nomes (com valor null), mas o token de escrita vê os valores.

Ativar e desativar

Clique no botão de pausa para desativar o domínio. Ele passa a mostrar a capa de site inativo em vez do site. Clique no botão de play para reativar.

  • Os arquivos, o banco e as configurações ficam intactos.
  • Em app Node.js, o serviço da app é parado e não sobe no boot enquanto o domínio estiver inativo.
  • O texto da capa é editado em Modo de Operacao > Capa de site inativo.

Outros botões da linha

Botão O que faz
Pasta Abre o document root no Gerenciador de Arquivos.
{ } Edita as variáveis de ambiente do domínio (só sites PHP). Veja acima.
Converter para app Node.js Transforma o site PHP em app Node.js. Veja Apps Node.js.
Deploy (git pull + build) Executa o pipeline de deploy. Veja Staging e deploy.
Criar staging (clonar site) Cria uma cópia de testes. Veja Staging e deploy.
Lixeira Remove o domínio.

Um domínio criado como staging mostra o selo staging no lugar do botão de clonar.

Remover um domínio

  1. Clique na lixeira da linha.
  2. Confirme.

O painel remove o vhost e, em app Node.js, o serviço da app.

Ficam mantidos:

  • os arquivos do site na home do usuário;
  • o pool PHP-FPM da conta;
  • os bancos de dados;
  • o domínio no HAProxy e o registro na Cloudflare.

Atenção: se não for recriar o site, remova também o domínio nas telas HAProxy e Cloudflare DNS e apague os arquivos que não forem mais usados.

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!