Versão padrão de PHP no WHM para contas novas
Onde o WHM define a versão herdada por toda conta nova, como fixar PHP-FPM no padrão e como achar os sites de clientes presos em versão sem suporte.

Resposta curta: a versão padrão vem do WHM, em MultiPHP Manager, na linha System Default: toda conta nova herda essa versão, e domínios marcados como "inherit" mudam junto. Domínios com versão fixada manualmente não mudam e precisam de varredura separada.
Neste artigo
- A versão do PHP é decidida no servidor, não na conta
- Onde o WHM guarda o padrão, em MultiPHP Manager
- O System Default controla o futuro, não os domínios já fixados
- Fazer contas novas nascerem com PHP-FPM ligado
- Limites de PHP em Tweak Settings que acompanham a decisão
- Como achar os domínios que ficaram em versões antigas
- A frase que explica a troca de versão ao cliente final
- O documento de padrão para quem mantém vários WHM
A versão do PHP é decidida no servidor, não na conta
Quando você cria uma conta nova no WHM, ela não nasce "sem PHP". Ela nasce com a versão que o servidor manda, e essa versão foi escolhida uma vez, provavelmente em um dia em que ninguém estava pensando nisso. Seis meses depois o site do cliente está em uma versão que já saiu do suporte de segurança e ninguém escolheu nada: herdou.
Isso é um problema de revenda, não de conta. Se você administra o WHM (servidor dedicado, VPS ou revenda com acesso a MultiPHP Manager), a decisão é sua e vale para todos os domínios que entrarem a partir de agora. Se você é revendedor sem acesso ao MultiPHP Manager em nível de servidor, o padrão herdado é o do provedor, e o caminho é a seção Varredura, mais adiante, no item escrito para quem só tem cPanel.
O ponto prático: definir isso uma vez elimina a tarefa repetitiva de ajustar a versão em cada conta nova, e elimina a versão esquecida que só aparece quando o site quebra.
Onde o WHM guarda o padrão, em MultiPHP Manager
No WHM, o caminho é Home » Software » MultiPHP Manager. A tela tem duas partes que as pessoas confundem:
- PHP Version (topo, bloco de configuração do sistema): a linha System Default. É o padrão herdado por domínios que não têm versão própria definida. É esta a decisão de revenda.
- Lista de domínios (tabela abaixo): a versão de cada vhost. Domínio que aparece como "inherit" segue o System Default. Domínio com versão explícita ignora o System Default para sempre, até alguém voltar a colocá-lo em "inherit".
A lista de versões disponíveis é a lista de pacotes ea-phpXX instalados pelo EasyApache 4. Se a versão que você quer como padrão não aparece, ela não está instalada: instale primeiro em EasyApache 4, com as extensões que seus sites usam, e só depois mude o System Default.
Ao lado da versão existe o seletor de PHP handler por versão (PHP-FPM, CGI, suPHP, conforme o que o servidor tem). Esse seletor também é de nível de servidor por versão, não por conta.
O System Default controla o futuro, não os domínios já fixados
Esta é a parte que gera susto. Trocar o System Default não reescreve o que já foi escolhido manualmente.
| Situação do domínio | Efeito ao mudar o System Default |
|---|---|
| Conta nova, criada depois da mudança | Nasce na nova versão |
| Domínio marcado como "inherit" | Passa a rodar a nova versão imediatamente |
Domínio com versão explícita (ex.: ea-php74 fixado) |
Não muda nada, continua na versão fixada |
| Subdomínio ou addon com versão própria | Não muda nada |
.htaccess com handler de PHP escrito à mão |
Pode sobrescrever tudo e ignorar o MultiPHP Manager |
Diretivas em .user.ini ou php.ini do usuário |
Continuam valendo, são ajustes de configuração, não de versão |
A consequência operacional: o servidor pode estar "no PHP 8.x" e ter dezenas de domínios em versões antigas fixadas anos atrás. O System Default dá a você o controle do futuro, não do passado. O passado você precisa varrer.
Fazer contas novas nascerem com PHP-FPM ligado
No MultiPHP Manager, o PHP-FPM aparece em dois lugares, e os dois importam:
- Por domínio, na coluna de PHP-FPM da lista de domínios: liga ou desliga o FPM para aquele vhost.
- Configuração de sistema, no bloco de PHP-FPM: a opção que faz novas contas já nascerem com PHP-FPM ligado. É essa que você quer marcada se o padrão da sua operação é FPM.
Antes de ligar em massa, duas verificações que evitam um domingo ruim:
- Memória. Cada pool de PHP-FPM reserva processos. Em servidor com muitas contas e pouca RAM, ligar FPM para todo mundo de uma vez pode levar o Apache a falhar ao iniciar. Ajuste
max_children,process_idle_timeoutemax_requestsnos pools (WHM permite editar valores padrão do pool) antes de generalizar. - Regras no
.htaccess. Sites antigos às vezes carregam linhas de handler que conflitam com o FPM. Vale umgrepantes.
Comandos de leitura, para rodar como root e validar o estado antes de mudar qualquer coisa (exemplo, confira a saída no seu servidor):
# versões ea-php instaladas no servidor
rpm -qa | grep -E '^ea-php[0-9]+-php-' | sort
# procurar handlers de PHP escritos à mão nos .htaccess dos clientes
grep -rIl --include=.htaccess -E 'AddHandler|AddType .*php|php[0-9]*-script' /home/*/public_html 2>/dev/null
O primeiro devolve uma linha por pacote, no formato ea-php83-php-8.3.6-1.el8.x86_64. O prefixo ea-phpXX de cada linha é uma das versões que aparecem no MultiPHP Manager para escolher como padrão. Se a saída vier vazia, não conclua que o servidor está sem PHP: confira a lista em EasyApache 4, que é a fonte de verdade da interface. O segundo comando mostra quais sites vão ignorar sua escolha.
Limites de PHP em Tweak Settings que acompanham a decisão
Definir a versão padrão resolve metade. A outra metade são os limites e opções de PHP que o WHM aplica no servidor inteiro, agrupados na seção PHP de Home » Server Configuration » Tweak Settings. A lista de opções dessa seção e o que cada uma faz está na documentação oficial do cPanel para Tweak Settings: PHP, e é lá que você deve conferir o nome e o efeito exato de cada item na sua versão do WHM, em vez de confiar na memória.
Trate essa tela como parte do mesmo padrão de revenda: ela é o lugar onde você define o comportamento base, e .user.ini ou MultiPHP INI Editor são os lugares onde um site específico se desvia dele. Documentar essa separação em uma página interna da agência economiza a discussão "por que esse site aceita upload de 64 MB e aquele não".
Como achar os domínios que ficaram em versões antigas
O objetivo é uma lista de domínios por versão, em minutos, sem abrir conta por conta.
Lendo a lista de versões pela interface, com e sem WHM
MultiPHP Manager lista todos os domínios do servidor com a versão de cada um. Ordene pela coluna de versão. Os que estão em versões antigas e não aparecem como "inherit" são os fixados manualmente: esses são seu backlog.
Sem acesso ao WHM, a varredura é conta por conta: no cPanel de cada uma, Software » MultiPHP Manager mostra os domínios daquela conta e a versão de cada um, com a mesma marca de "inherit". Não existe visão de servidor aí, então o controle precisa ser externo: uma planilha com conta, domínio, versão atual, se está em "inherit" e data da última conferência. Vinte contas levam cerca de meia hora na primeira passada e poucos minutos nas seguintes, porque só muda o que você mesmo mexeu. Quando o provedor subir o padrão dele, os domínios em "inherit" acompanham e os fixados ficam parados: a coluna "inherit" da planilha é o que diz quem vai precisar de você.
Listando a versão de cada vhost pela linha de comando
O WHM expõe as mesmas informações via API. Como root, o comando abaixo lista a versão de cada vhost (exemplo; confirme a sintaxe disponível no seu servidor com whmapi1 --help):
whmapi1 php_get_vhost_versions
A resposta vem em JSON, com uma entrada por vhost trazendo o nome do domínio, a versão em uso e se ela é herdada. Confirme que rodou olhando o campo result dentro de metadata: 1 é sucesso, 0 vem acompanhado de reason com o erro. Antes de usar a lista como inventário, compare a contagem de domínios com a que o MultiPHP Manager mostra na interface; se divergir, você rodou com usuário sem permissão ou o nome da função mudou na sua versão.
Se quiser só o resumo "quantos domínios em cada versão", jogue a saída em um arquivo e conte por versão. Evite pipelines longos: a saída é estruturada e vale mais ser lida do que espremida.
Os seis passos antes de trocar a versão de um cliente
| Passo | O que fazer |
|---|---|
| 1 | Anotar versão atual e versão alvo do domínio |
| 2 | Backup completo (arquivos + banco) antes de qualquer troca |
| 3 | Atualizar WordPress, tema e plugins antes de subir a versão de PHP |
| 4 | Rodar um verificador de compatibilidade de PHP no código do site |
| 5 | Trocar a versão no MultiPHP Manager e testar login, checkout, formulário e envio de e-mail |
| 6 | Deixar o domínio em "inherit" quando ele estiver na versão padrão, para não virar o próximo esquecido |
O passo 6 é o que fecha o ciclo. Domínio em "inherit" é domínio que acompanha o servidor sozinho na próxima vez.
A frase que explica a troca de versão ao cliente final
O cliente não quer saber de vhost nem de handler. Uma frase pronta, que funciona em e-mail e em reunião:
Para quem perguntar o custo: o trabalho não é trocar a versão, que leva segundos. É testar o que o tema e os plugins fazem depois da troca. Cobrar por isso é cobrar por teste, e vale dizer com essas palavras.
O documento de padrão para quem mantém vários WHM
Se você mantém mais de um WHM, escreva o padrão em um documento curto e aplique igual em todos:
- Versão de PHP padrão do sistema (e a data em que foi definida).
- Handler padrão (FPM ligado para contas novas, sim ou não).
- Lista de extensões obrigatórias instaladas no EasyApache 4.
- Valores de Tweak Settings que você mudou em relação ao padrão, com o motivo de cada um, conferidos na documentação do cPanel.
- Data da próxima revisão: coloque no calendário junto do calendário de fim de suporte das versões de PHP, não "quando der".
Duas coisas que recomendo contra o reflexo comum. Primeira: não suba o System Default para a versão mais nova no dia em que ela aparece no EasyApache. Deixe o parque amadurecer e suba quando seus temas e plugins habituais já estiverem testados. Segunda: não fixe versão manualmente em domínio que não precisa. Cada fixação é um site que deixa de acompanhar o servidor e que você vai ter que lembrar de revisar à mão, um por um, no ano que vem.
Referências
- Documentação oficial (cpanel) — Tweak Settings: PHP. Consultado em 2026-10-02.