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/publicem 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.
-
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)".
-
Na janela, escreva uma variável por linha, no formato
CHAVE=valor:# loja principal MAGE_RUN_CODE=base MAGE_RUN_TYPE=websiteLinhas que começam com
#são comentários. Também dá para colar linhas no formatoSetEnv CHAVE valor. -
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,PATHe os que começam comHTTP_,SERVER_,REMOTE_,REQUEST_,SCRIPT_ouDOCUMENT_.
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
.envda 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 usagetenv()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,
failedouinactive): 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:
- Abra Meus Dominios.
- No quadro PHP-FPM, encontre a versão usada pelo seu site.
- Clique em Reload.
- Confirme em OK na pergunta "Recarregar (reload) PHP 8.3-FPM?".
- 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 optimizeoubin/magento cache:flush) e então faça o Reload para limpar o OPcache.
Ver o estado detalhado (Status)
- Clique em Status na linha da versão do PHP.
- 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.
- Estado do serviço (por exemplo,
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 |