Instalar uma versão do PHP no Servidor Web com cPanel e WHM

Instalar uma versão do PHP no servidor web com cPanel e WHM é uma das tarefas mais recorrentes na administração de ambientes de hospedagem profissional. O PHP é a linguagem que move a grande maioria das aplicações web modernas, incluindo WordPress, Joomla, Magento e Laravel, e cada projeto pode exigir uma versão específica para funcionar corretamente.

O cPanel e o WHM oferecem um ecossistema completo para esse gerenciamento, centralizado no EasyApache 4 e no MultiPHP Manager. Por meio dessas ferramentas, o administrador instala novas versões do PHP, seleciona extensões, atribui versões diferentes para cada domínio e ajusta as diretivas do php.ini sem interferir nos demais sites hospedados no mesmo servidor.

Dessa forma, um servidor gerenciado pelo WHM consegue atender simultaneamente aplicações modernas que exigem PHP 8.3 e sistemas legados que ainda dependem do PHP 7.4, sem conflitos e sem a necessidade de ambientes separados. Portanto, dominar esse processo é indispensável para qualquer administrador que gerencia servidores cPanel em produção.

Nas seções a seguir, você vai aprender o passo a passo completo para instalar e configurar uma nova versão do PHP no servidor web com cPanel e WHM, tanto pela interface gráfica quanto pela linha de comando.

Por Que Instalar uma Nova Versão do PHP no Servidor Web Faz Diferença

O PHP é a linguagem de programação que sustenta a grande maioria das aplicações web hospedadas em servidores cPanel, incluindo WordPress, Joomla, Magento, Laravel e centenas de outros sistemas. Cada versão do PHP traz melhorias de desempenho, correções de segurança e novos recursos, mas também pode quebrar a compatibilidade com aplicações mais antigas que dependem de funções depreciadas.

Por isso, administradores de servidores WHM precisam manter múltiplas versões do PHP instaladas simultaneamente, garantindo que cada conta de hospedagem utilize exatamente a versão que sua aplicação exige. Um servidor que oferece apenas uma versão de PHP força todos os sites a operarem sob as mesmas condições, o que inevitavelmente gera conflitos entre aplicações modernas e sistemas legados.

No cPanel e WHM, o processo de instalar uma versão do PHP no servidor web é centralizado em duas ferramentas complementares: o EasyApache 4, responsável pela instalação dos pacotes PHP via repositório oficial, e o MultiPHP Manager, responsável por atribuir cada versão instalada aos domínios e contas de hospedagem correspondentes.

Nas seções a seguir, você vai aprender como instalar uma nova versão do PHP pelo WHM, como configurar extensões, como atribuir versões por domínio e como ajustar o php.ini para cada ambiente sem afetar os demais sites do servidor.

Como Funciona o Gerenciamento de PHP no cPanel e WHM

Antes de instalar qualquer versão do PHP, é importante entender como o cPanel organiza esse gerenciamento. O ecossistema é composto por três camadas interdependentes que trabalham juntas.

A primeira camada é o EasyApache 4, que instala os pacotes PHP no sistema operacional do servidor via repositório RPM da cPanel. Cada versão do PHP é tratada como um conjunto de pacotes independentes, como ea-php82, ea-php81 e ea-php74, o que permite coexistência sem conflitos.

A segunda camada é o MultiPHP Manager, acessível pelo WHM, que define qual versão do PHP é utilizada por cada domínio ou conta de hospedagem. Dessa forma, o domínio loja.com pode rodar PHP 8.2 enquanto o domínio sistema-antigo.com continua operando em PHP 7.4 no mesmo servidor.

A terceira camada é o MultiPHP INI Editor, que permite ajustar as diretivas do php.ini por versão ou por domínio, controlando parâmetros como memory_limit, upload_max_filesize, max_execution_time e outros sem interferir nas configurações globais do servidor.

Instalar uma Versão do PHP no Servidor via EasyApache 4

O processo de instalar PHP no WHM começa pelo EasyApache 4. Acesse o WHM em https://seuservidor.com:2087, faça login como root e siga o caminho Software > EasyApache 4.

Passo 1: Selecionar o Perfil Atual

Na tela inicial do EasyApache 4, clique em Personalizar ao lado do perfil atualmente instalado. Assim, todas as configurações existentes serão preservadas e apenas os novos componentes serão adicionados.

Passo 2: Selecionar a Nova Versão do PHP

Na etapa de seleção de PHP, o EasyApache 4 exibirá todas as versões disponíveis no repositório. Marque a versão que deseja instalar, como PHP 8.3 ou PHP 8.2, sem desmarcar as versões já instaladas que estejam em uso por contas ativas. As versões disponíveis atualmente no repositório do EasyApache 4 são:

• PHP 5.6 (legado, sem suporte de segurança).
• PHP 7.2, 7.3 e 7.4 (fim de vida, uso apenas para sistemas legados).
• PHP 8.0 e 8.1 (suporte de segurança ativo).
• PHP 8.2 e 8.3 (versões estáveis recomendadas para novas instalações).

Portanto, em servidores novos ou para aplicações modernas, PHP 8.2 ou 8.3 são as escolhas mais indicadas.

Passo 3: Selecionar as Extensões da Nova Versão

Após selecionar a versão, o EasyApache 4 apresenta a lista de extensões disponíveis para aquela versão específica. As extensões mais utilizadas e recomendadas para ambientes de hospedagem compartilhada são:

• mbstring: manipulação de strings multibyte, obrigatória para WordPress e Joomla.
• curl: comunicação com APIs externas, essencial para WooCommerce e integrações.
• gd: manipulação de imagens, necessária para redimensionamento de thumbnails.
• intl: suporte a internacionalização, exigida pelo Magento e Symfony.
• zip: compressão e extração de arquivos, usada por plugins e backups.
• soap: comunicação via protocolo SOAP, necessária para integrações fiscais e ERPs.
• imagick: processamento avançado de imagens, recomendada para WordPress.
• opcache: cache de bytecode PHP, melhora significativamente o desempenho.
• pdo e mysqlnd: conexão com bancos de dados MySQL e MariaDB.

Selecione todas as extensões necessárias antes de avançar. Adicionar extensões depois exige uma nova execução do EasyApache 4, o que reinicia o Apache novamente.

Passo 4: Revisar e Provisionar

O EasyApache 4 exibirá um resumo de todos os pacotes que serão instalados. Revise a lista, confirme e clique em Provisionar. O processo será exibido em tempo real no terminal embutido do WHM. Ao final, o Apache será reiniciado automaticamente para carregar os novos módulos.

Instalar PHP no WHM via Linha de Comando

Em servidores administrados remotamente ou em fluxos de automação, instalar versões PHP cPanel via terminal é mais eficiente. O comando abaixo instala o PHP 8.3 com as extensões mais comuns:

yum install ea-php83 ea-php83-php-cli ea-php83-php-common \
ea-php83-php-mbstring ea-php83-php-curl ea-php83-php-gd \
ea-php83-php-intl ea-php83-php-zip ea-php83-php-opcache \
ea-php83-php-mysqlnd ea-php83-php-pdo ea-php83-php-soap

Para verificar se a instalação foi concluída com sucesso:

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

O retorno deve exibir a versão instalada e a data de compilação. Dessa forma, confirma-se que o binário PHP 8.3 está disponível e funcional no servidor.

Configurar PHP por Domínio com o MultiPHP Manager

Com a nova versão do PHP instalada via EasyApache 4, o próximo passo é atribuí-la aos domínios que devem utilizá-la. Esse controle é feito pelo MultiPHP Manager no WHM.

Acesse Home > Software > MultiPHP Manager. A tela exibirá todos os domínios e contas de hospedagem do servidor, com a versão de PHP atualmente atribuída a cada um. Para alterar a versão de um ou mais domínios:

1. Marque os domínios que devem utilizar a nova versão.
2. No menu suspenso PHP Version, selecione a versão desejada.
3. Clique em Apply.

A alteração é imediata e não requer reinicialização do Apache. Portanto, é possível migrar domínios para uma nova versão de PHP sem nenhuma interrupção no serviço.

Configurar PHP por Domínio pelo cPanel do Usuário

Além do WHM, cada usuário com acesso ao cPanel pode gerenciar a versão de PHP do próprio domínio, caso o administrador do servidor permita essa funcionalidade. No cPanel, o caminho é Software > MultiPHP Manager, onde o usuário seleciona a versão desejada para cada domínio ou subdomínio da conta.

Ajustar o php.ini por Versão com o MultiPHP INI Editor

Após instalar e atribuir a versão do PHP, é comum precisar ajustar parâmetros do php.ini para atender requisitos específicos de aplicações. No WHM, o MultiPHP INI Editor permite editar essas diretivas de forma segura, sem risco de corromper o arquivo de configuração global.

Acesse Home > Software > MultiPHP INI Editor. Selecione a versão do PHP que deseja configurar e ajuste os parâmetros conforme necessário. Os ajustes mais frequentes em ambientes de hospedagem são:

Diretiva	Valor Recomendado	Finalidade
memory_limit	256M	Memória máxima por processo PHP
upload_max_filesize	64M	Tamanho máximo de arquivo enviado
post_max_size	64M	Tamanho máximo de dados POST
max_execution_time	120	Tempo máximo de execução em segundos
max_input_vars	5000	Variáveis máximas por requisição
display_errors	Off	Ocultar erros em produção
opcache.enable	1	Ativar cache de bytecode
opcache.memory_consumption	128	Memória reservada para OPcache em MB

Além do editor visual, é possível editar o php.ini diretamente pelo terminal. O arquivo de configuração de cada versão fica em:

/opt/cpanel/ea-php83/root/etc/php.ini

Após qualquer alteração manual no php.ini, recarregue o PHP-FPM da versão correspondente:

systemctl restart ea-php83-php-fpm

Verificar Quais Versões de PHP Estão Instaladas no Servidor

Para listar todas as versões de PHP atualmente instaladas no servidor via EasyApache 4, execute o comando abaixo no terminal:

yum list installed | grep ea-php

O resultado exibirá todos os pacotes PHP instalados, organizados por versão. Assim, é fácil identificar quais versões estão disponíveis para atribuição no MultiPHP Manager e quais extensões já estão presentes em cada uma.

Perguntas Frequentes

1. É possível instalar múltiplas versões de PHP ao mesmo tempo no cPanel?

Sim. O EasyApache 4 permite instalar quantas versões de PHP forem necessárias no mesmo servidor. Cada versão opera de forma independente, e o MultiPHP Manager controla qual versão é atribuída a cada domínio ou conta de hospedagem.

2. Instalar uma nova versão de PHP afeta os sites já hospedados no servidor?

Não diretamente. A instalação de uma nova versão via EasyApache 4 apenas adiciona pacotes ao sistema. Os domínios existentes continuam utilizando a versão de PHP previamente atribuída a eles no MultiPHP Manager, sem nenhuma alteração automática.

3. Como saber qual versão de PHP cada domínio está usando no WHM?

Acesse Home > Software > MultiPHP Manager no WHM. A tela exibe todos os domínios do servidor com a versão de PHP atribuída a cada um. Além disso, o próprio usuário consegue verificar e alterar a versão pelo cPanel da conta, se o administrador liberar essa permissão.

4. O que acontece se eu remover uma versão de PHP que ainda está em uso?

Os domínios que utilizam a versão removida passarão a usar a versão padrão do servidor, o que pode causar erros ou quebras em aplicações incompatíveis. Portanto, antes de remover qualquer versão, verifique no MultiPHP Manager quais domínios a utilizam e migre-os para uma versão compatível.

Conclusão

Instalar uma versão do PHP no servidor web com cPanel e WHM é um processo estruturado e seguro quando realizado pelas ferramentas corretas. O EasyApache 4 cuida da instalação dos pacotes PHP no sistema operacional, o MultiPHP Manager distribui as versões entre os domínios e o MultiPHP INI Editor garante que cada ambiente tenha as configurações adequadas para a aplicação que hospeda.

Além disso, a possibilidade de manter múltiplas versões PHP cPanel ativas simultaneamente é um diferencial importante para servidores de hospedagem compartilhada, onde convivem aplicações modernas e sistemas legados com requisitos distintos. Portanto, dominar esse fluxo de instalação e configuração de PHP no WHM é uma competência fundamental para qualquer administrador que gerencia servidores cPanel em ambiente de produção.