blog
Revenda

PHP 8.3 não aparece no MultiPHP Manager: instale pelo EasyApache 4

Como instalar uma versão de PHP pelo EasyApache 4, marcar as extensões certas antes e auditar quais domínios ainda rodam versão sem suporte.

JR · · 8 min de leitura · 1 tabela · 6 blocos de código

Resposta curta: a versão só aparece no MultiPHP Manager depois de ser instalada no servidor pelo EasyApache 4 (WHM → Software → EasyApache 4 → Customize → PHP Versions), junto com as extensões daquela versão. O seletor da conta lista apenas o que já existe na máquina.

Neste artigo
  1. Por que a versão não aparece no menu da conta
  2. Levante o que cada site usa antes de instalar
  3. Instale a versão pelo EasyApache 4
  4. Gere o inventário de quem ainda está em versão antiga com php_get_vhost_versions
  5. Remover a versão antiga: o que acontece com quem apontava para ela
  6. Como explicar ao cliente
  7. Rotina reutilizável para carteira de sites

Quando o cliente pede "coloca PHP 8.3 nesse site" e o menu do MultiPHP Manager só mostra até 8.1, não falta permissão: falta pacote instalado no servidor. Em servidor com cPanel/WHM, o que alimenta esse menu é o EasyApache 4. Cada versão de PHP é um conjunto de pacotes (ea-phpXX e seus ea-phpXX-php-*), e a interface de conta só lista o que já existe na máquina.

O roteiro abaixo é o que uso para não quebrar site de cliente no caminho: levantar o que cada site carrega antes de instalar, instalar versão com as extensões certas, auditar quem ainda está preso em versão sem suporte e só então decidir sobre remover a antiga.

Por que a versão não aparece no menu da conta

O MultiPHP Manager (tanto o do WHM quanto o do cPanel da conta) é um seletor, não um instalador. Ele oferece as versões de PHP que o EasyApache 4 instalou no servidor, conforme a documentação do EasyApache 4: PHP. Se ea-php83 não está instalado, o domínio não tem como apontar para ele.

Dois sintomas que confundem:

Para confirmar o que o servidor realmente tem, por linha de comando:

whmapi1 php_get_installed_versions
whmapi1 php_get_system_default_version

Esses comandos whmapi1 são verificação prática de operação, não estão descritos na página do EasyApache 4 citada acima; a nomenclatura deles pertence à WHM API 1.

Levante o que cada site usa antes de instalar

Instalar "PHP 8.3 básico" e descobrir depois que o site do cliente usa imagick, soap ou intl é o jeito mais rápido de transformar uma tarefa de 20 minutos em plantão noturno. A ordem correta é inventário primeiro.

Liste os módulos disponíveis na versão atual

Cada versão do EA4 fica em seu próprio prefixo. Rodando o binário da versão em uso pelo site:

/opt/cpanel/ea-php81/root/usr/bin/php -m

Isso mostra o que está disponível naquela versão, não o que o site chama. É o teto, e serve de linha de base para a versão nova.

Descubra quais extensões o código realmente chama

No diretório do site, procure as funções que denunciam extensão:

cd /home/CLIENTE/public_html
grep -rl --include="*.php" -e "imagick" -e "SoapClient" -e "Collator" -e "bcadd" -e "ZipArchive" .

Em WordPress, o atalho mais honesto é a tela Ferramentas → Saúde do site → Informações, que lista as extensões PHP detectadas e aponta as recomendadas que faltam. Plugin de pagamento costuma exigir curl, openssl e mbstring; loja com geração de imagem usa gd ou imagick; integração com ERP quase sempre usa soap ou zip.

Monte a lista por site, não por servidor

Uma planilha de três colunas resolve: domínio, versão atual, extensões não padrão. Quem administra 30 sites evita reinstalar pacote esquecido se consolidar essa lista antes de abrir o EasyApache.

Ordem segura para subir uma versão de PHPInventárioExtensões e versão por siteProvisionarEA4 instala versão e módulosTestarStaging dos sites críticosMigrarLotes pelo MultiPHP ManagerRemoverSó com lista zerada
Ordem que evita descobrir extensão faltando depois do provisionamento.

Instale a versão pelo EasyApache 4

No WHM, o caminho é Software → EasyApache 4 → Customize (no perfil em uso), aba PHP Versions, marque a versão desejada, depois aba PHP Extensions para marcar os módulos daquela versão, e por fim Review → Provision. O EA4 resolve dependências e mostra o que será instalado antes de executar.

Uma observação que vem da documentação e outra que vem da operação:

Instalar os pacotes ea-php pela linha de comando

Se preferir terminal, os pacotes seguem nomenclatura previsível:

# exemplo: instalar PHP 8.3 com extensões comuns de WordPress/WooCommerce
dnf install ea-php83 ea-php83-php-mysqlnd ea-php83-php-gd \
  ea-php83-php-mbstring ea-php83-php-curl ea-php83-php-zip \
  ea-php83-php-intl ea-php83-php-soap

/opt/cpanel/ea-php83/root/usr/bin/php -v
/opt/cpanel/ea-php83/root/usr/bin/php -m

Substitua dnf por yum conforme a distribuição do servidor. Depois de instalar, confirme que a versão passou a aparecer na API:

whmapi1 php_get_installed_versions

Aparecer aqui é condição necessária, não suficiente: confirma que a versão está instalada, mas ela só vira opção no seletor se o handler/SAPI em uso (PHP-FPM ou CGI/suPHP) tiver sido provisionado para ela no EA4.

Gere o inventário de quem ainda está em versão antiga com php_get_vhost_versions

Esta é a parte que ninguém faz e que depois vira incidente. Com todas as versões instaladas, o WHM tem Software → MultiPHP Manager, que lista contas e domínios com a versão de PHP de cada um e permite alterar em lote.

Para exportar e trabalhar fora da interface:

whmapi1 php_get_vhost_versions

A saída traz, por vhost, a versão em uso e se ela é herdada. Filtrando pela versão que você quer aposentar, sai a lista exata de domínios a tratar.

Um mapa de decisão que uso para classificar a lista:

Situação do domínio O que fazer antes de mudar
Aponta explicitamente para versão sem suporte Testar em staging na versão nova, depois trocar
Está como inherit Checar qual é o padrão do sistema; mudar o padrão move todos de uma vez
Usa extensão que não foi marcada na versão nova Instalar a extensão antes de trocar, nunca depois
Site legado sem manutenção contratada Avisar o cliente por escrito antes de qualquer mudança
CMS desatualizado (core antigo) Atualizar o CMS primeiro, PHP depois

Remover a versão antiga: o que acontece com quem apontava para ela

Aqui mora o risco real. Ao desinstalar uma versão de PHP pelo EasyApache 4, os domínios que estavam apontados para ela deixam de ter aquele handler e passam a ser servidos pela versão padrão do sistema. O site não some do ar por falta de PHP: ele passa a rodar em um PHP que talvez nunca tenha rodado antes.

O que costuma quebrar nesse salto:

Checklist antes de remover:

  1. Rodar whmapi1 php_get_vhost_versions e confirmar que nenhum vhost aponta para a versão a ser removida.
  2. Conferir qual é o padrão do sistema, porque é ele que vai receber qualquer esquecido.
  3. Comparar php -m da versão antiga com a da nova e fechar a diferença de extensões.
  4. Backup antes do provisionamento, mesmo que pareça exagero.
  5. Remover a versão e revalidar os sites críticos (checkout, formulário, login, envio de e-mail).

Se houver um único site legado que ainda não pode migrar, a decisão mais barata costuma ser manter a versão antiga instalada mais um ciclo em vez de forçar a remoção. Versão antiga instalada e usada por um domínio conhecido é risco controlado; versão antiga removida com domínio órfão caindo no padrão é risco descoberto.

Checklist antes de remover a versão antigaRodar php_get_vhost_versionsNenhum vhost na versão antigaConferir padrão do sistemaEle recebe os esquecidosComparar php -mFechar diferença de extensõesReplicar php.inimemory_limit e upload_max_filesizeBackup e provisionarDepois revalidar sites críticos
Se algum passo falhar, mantenha a versão antiga instalada mais um ciclo.

Como explicar ao cliente

Uma frase que funciona em orçamento e em e-mail de aviso:

Ela diz o risco, diz o método e já abre espaço para o trabalho extra sem parecer venda empurrada.

Rotina reutilizável para carteira de sites

Para quem mantém dezenas de sites, a tarefa só escala se virar processo fixo:

  1. Trimestral: exportar php_get_vhost_versions de cada servidor e marcar na planilha quem está em versão sem suporte.
  2. Antes de qualquer instalação: consolidar a lista de extensões de todos os sites do servidor, não de um só.
  3. Uma única janela de provisionamento por servidor, instalando versão e extensões juntas, em vez de três provisionamentos seguidos.
  4. Salvar o perfil do EA4 e aplicá-lo nos outros servidores da carteira.
  5. Migrar em lotes pelo MultiPHP Manager, começando pelos sites institucionais simples e deixando loja e sistema sob medida por último.
  6. Só depois de zerar a lista, remover a versão antiga.

O ponto onde a maioria trava não é a instalação: é descobrir tarde que uma extensão não foi marcada. Inverter a ordem, inventário antes de provisionamento, resolve isso sem nenhum comando exótico.

Referência da interface do EasyApache 4 e da nomenclatura dos pacotes ea-php*: EasyApache 4: PHP, documentação oficial do cPanel.

Referências

  1. Documentação oficial (cpanel) — EasyApache 4: PHP. Consultado em 2026-10-13.
Leia também