blog
Revenda

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.

JR · · 8 min de leitura · 2 tabelas · 2 blocos de código

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
  1. A versão do PHP é decidida no servidor, não na conta
  2. Onde o WHM guarda o padrão, em MultiPHP Manager
  3. O System Default controla o futuro, não os domínios já fixados
  4. Fazer contas novas nascerem com PHP-FPM ligado
  5. Limites de PHP em Tweak Settings que acompanham a decisão
  6. Como achar os domínios que ficaram em versões antigas
  7. A frase que explica a troca de versão ao cliente final
  8. 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:

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.

Quem muda quando você troca o System DefaultConta novaNasce na nova versãoDomínio em inheritMuda na horaVersão fixadaContinua na versão antigaHandler no .htaccessPode ignorar o MultiPHP
Trocar o System Default controla o futuro, não o que já foi fixado à mão.

Fazer contas novas nascerem com PHP-FPM ligado

No MultiPHP Manager, o PHP-FPM aparece em dois lugares, e os dois importam:

  1. Por domínio, na coluna de PHP-FPM da lista de domínios: liga ou desliga o FPM para aquele vhost.
  2. 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:

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.

Seis passos antes de trocar a versão1. RegistrarVersão atual e versão alvo2. BackupArquivos e banco3. AtualizarCore, tema e plugins4. VerificarCompatibilidade do código5. Trocar e testarLogin, checkout, formulário, e-mail6. Voltar a inheritDomínio acompanha o servidor
Sequência reutilizável antes de subir a versão de PHP de um cliente.

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:

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

  1. Documentação oficial (cpanel) — Tweak Settings: PHP. Consultado em 2026-10-02.
Leia também