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.

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
- Por que a versão não aparece no menu da conta
- Levante o que cada site usa antes de instalar
- Instale a versão pelo EasyApache 4
- Gere o inventário de quem ainda está em versão antiga com php_get_vhost_versions
- Remover a versão antiga: o que acontece com quem apontava para ela
- Como explicar ao cliente
- 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:
- A versão existe no EA4 mas a conta não mostra escolha. São dois casos diferentes. (a) O vhost está em
inherit: ele segue o padrão do sistema e o MultiPHP Manager exibe "inherit" em vez da versão nominal. A versão nova continua na lista suspensa; basta selecioná-la para sair da herança. Confira o padrão em MultiPHP Manager → PHP Version (System Default). (b) A versão foi instalada sem nenhum SAPI/handler provisionado (semea-phpXX-php-climais o handler em uso, PHP-FPM ou CGI/suPHP): aí ela não vira opção utilizável. Valide comwhmapi1 php_get_installed_versions, que lista a versão, e com a presença do binário em/opt/cpanel/ea-phpXX/root/usr/bin/php; se a versão aparece na API mas não como opção no seletor, volte ao EA4 e marque o handler. - Você está em hospedagem compartilhada ou em conta de revenda. Nos dois casos não há EasyApache: revendedor administra as contas dos clientes dele, mas não tem root no servidor nem acesso ao EA4, então a lista de versões é a que o provedor instalou (pedir a instalação ao suporte é o único caminho). Esse artigo vale para quem tem acesso root ao WHM do próprio servidor: VPS, dedicado ou servidor gerenciado em que você entra como root.
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.
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:
- Extensões são por versão, como a documentação do EA4 descreve na nomenclatura dos pacotes
ea-phpXX-php-*. Marcarimagickno PHP 8.1 não habilita nada no 8.3. Cada versão tem seu próprio pacote de extensão. - O perfil pode ser salvo e reaproveitado. Isso não está na página citada, é prática de operação: se você tem mais de um servidor, salvar o perfil depois do primeiro provisionamento e aplicá-lo nos demais é a diferença entre padronizar e repetir cliques.
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:
- Código com sintaxe ou funções removidas na versão nova (fatal error, tela branca).
- Plugin ou tema antigo incompatível, especialmente em WordPress que ficou anos sem atualização.
- Extensão presente na versão antiga e não marcada na nova (o site carrega, mas o checkout ou o envio de e-mail falha de forma silenciosa).
- Diretivas de
php.inie valores dememory_limit/upload_max_filesizeque estavam ajustados na versão antiga e não foram replicados.
Checklist antes de remover:
- Rodar
whmapi1 php_get_vhost_versionse confirmar que nenhum vhost aponta para a versão a ser removida. - Conferir qual é o padrão do sistema, porque é ele que vai receber qualquer esquecido.
- Comparar
php -mda versão antiga com a da nova e fechar a diferença de extensões. - Backup antes do provisionamento, mesmo que pareça exagero.
- 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.
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:
- Trimestral: exportar
php_get_vhost_versionsde cada servidor e marcar na planilha quem está em versão sem suporte. - Antes de qualquer instalação: consolidar a lista de extensões de todos os sites do servidor, não de um só.
- Uma única janela de provisionamento por servidor, instalando versão e extensões juntas, em vez de três provisionamentos seguidos.
- Salvar o perfil do EA4 e aplicá-lo nos outros servidores da carteira.
- Migrar em lotes pelo MultiPHP Manager, começando pelos sites institucionais simples e deixando loja e sistema sob medida por último.
- 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
- Documentação oficial (cpanel) — EasyApache 4: PHP. Consultado em 2026-10-13.