# 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.

> 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.

João Rizzon · 2026-10-14 · Revenda

---

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](https://docs.cpanel.net/ea4/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 (sem `ea-phpXX-php-cli` mais o handler em uso, PHP-FPM ou CGI/suPHP): aí ela não vira opção utilizável. Valide com `whmapi1 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:

```bash
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:

```bash
/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:

```bash
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-*`. Marcar `imagick` no 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:

```bash
# 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:

```bash
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:

```bash
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.ini` e valores de `memory_limit`/`upload_max_filesize` que estavam ajustados na versão antiga e não foram replicados.

Checklist antes de remover:

- Rodar `whmapi1 php_get_vhost_versions` e 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 -m` da 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:

> **** "A versão de PHP que o seu site usa não recebe mais correções de segurança. Vamos instalar a versão nova no servidor, testar o site nela e só então trocar. Em alguns casos, um plugin antigo precisa ser atualizado ou substituído antes da troca, e isso eu informo antes de mexer."

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_versions` de 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](https://docs.cpanel.net/ea4/php/).

