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
- Na coluna PHP, escolha a nova versão na lista.
- 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
- Na coluna Rewrite, escolha Generico, Magento 2 ou Laravel.
- 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
- Clique no lápis ao lado do nome do domínio.
- Digite um alias por linha (ou separados por espaço ou vírgula). Aceita curinga:
*.exemplo.com.br. - Deixe vazio para remover todos.
- 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
- Clique no lápis ao lado do caminho, na coluna Document Root.
- Informe a nova pasta, relativa à home. Ex.:
public_html/public. - 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
- Clique em Editar pool PHP-FPM (ícone de arquivo de código) na linha do domínio.
- 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_timeoutememory_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'].
- 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. - 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 formatoSetEnv CHAVE valor. - 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 comHTTP_,SERVER_,REMOTE_,REQUEST_,SCRIPT_ouDOCUMENT_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
.envda tela Associacoes do cliente é lido pela aplicação (Laravel, dotenv) e não vira variável do PHP. Quem usagetenv()ou$_SERVERprecisa 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
- Clique na lixeira da linha.
- 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.