Comparativo: Gerenciadores de Pacotes no cPanel — onde fica, como funciona e como usar

14 min de leitura  ·  Guia técnico

Gerenciadores de pacotes no cPanel operam em duas camadas distintas: o EasyApache 4 (para módulos Apache e PHP) e o dnf/yum (para pacotes do sistema operacional), cada um com escopo e interface próprios. Entender onde cada ferramenta fica, o que ela gerencia e como usá-la evita conflitos de dependência e downtime desnecessário.

Pré-requisitos para gerenciar pacotes no cPanel e WHM

• Acesso root ao servidor via SSH ou ao painel WHM (porta 2087)
• Servidor rodando AlmaLinux 8/9, Rocky Linux 8/9 ou CloudLinux 8/9 com cPanel/WHM instalado
• cPanel/WHM atualizado para a versão estável mais recente (verifique em WHM > Update Config)
• Conhecimento básico de terminal Linux e permissões de usuário
• Backup recente do servidor antes de qualquer alteração de perfil EasyApache

Onde ficam os gerenciadores de pacotes no cPanel: mapa completo

A confusão mais comum entre administradores iniciantes é procurar um "gerenciador de pacotes" dentro do painel cPanel do usuário final — ele simplesmente não existe ali. O gerenciamento de software no ecossistema cPanel é dividido entre três camadas, cada uma com localização e propósito específicos.

Camada 1 — EasyApache 4 (WHM): acesse o WHM em https://seuservidor.com:2087, vá até o menu lateral e procure por Software > EasyApache 4. Esta é a interface principal para instalar, atualizar e remover versões do PHP, módulos do Apache (mod_rewrite, mod_headers, mod_ssl) e extensões PHP (curl, mbstring, intl, imagick, redis, etc.).

Camada 2 — Software Center (WHM): em WHM > Software > Software Center, você encontra pacotes adicionais mantidos pela cPanel Inc., como o Imunify360, JetBackup, e outros plugins de terceiros homologados para o ambiente cPanel.

Camada 3 — dnf/yum (terminal root): o gerenciador de pacotes nativo do AlmaLinux 9 ou Rocky Linux 9 é o dnf. Ele gerencia bibliotecas do sistema operacional, utilitários como git, curl, wget, unzip e dependências de sistema que o EasyApache não cobre. O acesso é exclusivamente via SSH com usuário root.

O usuário final do cPanel (sem root) não tem acesso a nenhuma dessas três camadas para instalação de software no nível do servidor. Ele pode, no entanto, usar o Composer para instalar bibliotecas PHP no diretório da aplicação, desde que as extensões necessárias já estejam compiladas no perfil EasyApache ativo.

EasyApache 4: como funciona e como usar na prática

O EasyApache 4 é o gerenciador de perfis de compilação do Apache e PHP específico do cPanel, substituindo o modelo antigo de compilação manual do EasyApache 3. Ele trabalha com repositórios RPM próprios mantidos pela cPanel Inc. e pela CloudLinux, garantindo compatibilidade com o ambiente gerenciado.

1. Acesse o WHM em https://seuservidor.com:2087 e faça login como root.
2. No menu lateral, clique em Software > EasyApache 4.
3. Na tela principal, você verá os perfis disponíveis. Clique em Customize no perfil atualmente provisionado.
4. Navegue pelas abas: Apache MPM, Apache Modules, PHP Versions e PHP Extensions.
5. Para adicionar uma extensão PHP (exemplo: php83-php-redis), clique na aba PHP Extensions, selecione a versão PHP desejada e marque a extensão.
6. Clique em Review e depois em Provision para aplicar as mudanças.

O processo de provisionamento reinicia o Apache automaticamente ao final. Em servidores com muitos domínios, isso pode levar de 2 a 10 minutos. Você verá o progresso em tempo real na tela do WHM.

Para realizar a mesma operação via linha de comando SSH (útil para automação), use:

dnf install ea-php83-php-redis --enablerepo=EA4

Output esperado:
Installed:
  ea-php83-php-redis-x.x.x-x.cpanel.x86_64

Complete!

Após a instalação, reinicie o PHP-FPM da versão correspondente:

/scripts/restartsrv_apache_php_fpm

dnf e yum no servidor cPanel: diferenças e quando usar cada um

Em servidores cPanel rodando AlmaLinux 9 ou Rocky Linux 9, o gerenciador de pacotes nativo é o dnf. Em servidores mais antigos com CentOS 7 (hoje em EOL), era o yum. Ambos gerenciam pacotes do sistema operacional — não módulos PHP ou perfis Apache.

Use o dnf para instalar ferramentas de sistema que o EasyApache não oferece:

dnf install git curl unzip htop -y

Output esperado:
Installed:
  git-2.43.x  curl-8.x  unzip-6.x  htop-3.x

Complete!

Atenção: nunca use dnf update sem verificar antes quais pacotes serão atualizados. Atualizações de bibliotecas como openssl ou glibc podem exigir reinicialização de serviços gerenciados pelo cPanel. Prefira:

dnf check-update

E então atualize pacotes específicos com segurança:

dnf update curl libcurl -y

A tabela de responsabilidades fica assim:

• EasyApache 4: versões PHP, módulos Apache, extensões PHP (redis, imagick, intl, mbstring)
• dnf/yum: git, curl, unzip, bibliotecas do SO, ferramentas de sistema
• Software Center (WHM): plugins cPanel de terceiros (Imunify, JetBackup, etc.)
• Composer: bibliotecas PHP no nível da aplicação, sem root

MultiPHP Manager: gerenciando versões PHP por domínio

Uma das funcionalidades mais poderosas do ecossistema cPanel é o MultiPHP Manager, que permite atribuir versões PHP diferentes para cada domínio hospedado no mesmo servidor — sem conflito entre aplicações.

1. No WHM, acesse Software > MultiPHP Manager.
2. Você verá a lista de todos os domínios e a versão PHP atual de cada um.
3. Para alterar a versão de um domínio específico, marque o checkbox ao lado do domínio.
4. No menu suspenso PHP Version, selecione a versão desejada (ex: PHP 8.3).
5. Clique em Apply.

O usuário final do cPanel também pode alterar a versão PHP do próprio domínio em cPanel > Software > MultiPHP Manager, mas apenas entre as versões já instaladas pelo administrador no EasyApache 4.

Para verificar qual versão PHP está ativa em um domínio via terminal:

php -v

Output esperado:
PHP 8.3.x (cli) (built: ...)
Copyright (c) The PHP Group

Se precisar verificar a versão PHP de um domínio específico via PHP-FPM:

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

Para uma visão mais ampla sobre como configurar o ambiente de hospedagem no servidor, consulte o artigo Configurando um Servidor Linux para Hospedagem de Sites.

Composer no cPanel: instalando bibliotecas PHP sem root

Usuários sem acesso root podem instalar dependências PHP via Composer diretamente no diretório da aplicação. Isso é possível porque o Composer opera no espaço do usuário, sem modificar extensões do sistema.

1. Acesse o servidor via SSH com o usuário cPanel (não root) ou use o Terminal do cPanel em Avançado > Terminal.
2. Navegue até o diretório da aplicação:

cd ~/public_html/minha-aplicacao

1. Baixe o Composer (se ainda não estiver disponível globalmente no servidor):

curl -sS https://getcomposer.org/installer | php

1. Instale as dependências do projeto:

php composer.phar install

Output esperado:
Loading composer repositories with package information
Installing dependencies (including require-dev)
  - Installing vendor/pacote (v1.x.x): Downloading (100%)
Generated autoload files

Atenção: se uma biblioteca PHP exigir uma extensão não compilada no perfil EasyApache ativo (como ext-sodium ou ext-imagick), o Composer retornará erro. Nesse caso, o administrador do servidor precisa habilitar a extensão via EasyApache 4 no WHM antes de prosseguir.

Para verificar quais extensões PHP estão disponíveis no servidor sem acesso root:

php -m

Output esperado:
[PHP Modules]
Core
curl
mbstring
redis
...
[Zend Modules]

Problemas comuns e como resolver

Sintoma: EasyApache 4 trava durante o provisionamento

Causa: conflito de dependências entre pacotes RPM, espaço em disco insuficiente em /usr ou processo de provisionamento anterior ainda em execução.
Solução: verifique o espaço em disco com df -h e certifique-se de ter pelo menos 2 GB livres em /. Verifique se há um processo de provisionamento travado com ps aux | grep easyapache e, se necessário, finalize-o com kill -9 [PID]. Em seguida, execute /scripts/easyapache4 --build via SSH para forçar o provisionamento manual.

Sintoma: extensão PHP instalada via EasyApache não aparece no phpinfo()

Causa: o PHP-FPM ou o Apache não foi reiniciado após o provisionamento, ou o domínio está usando uma versão PHP diferente da que recebeu a extensão.
Solução: reinicie os serviços com /scripts/restartsrv_apache_php_fpm e verifique no MultiPHP Manager se o domínio está usando a versão PHP correta. Confirme a extensão com /opt/cpanel/ea-php83/root/usr/bin/php -m | grep redis.

Sintoma: dnf retorna conflito com pacotes cPanel

Causa: tentativa de instalar via dnf um pacote que o cPanel gerencia internamente (como versões do Apache ou OpenSSL customizadas), causando conflito de versão.
Solução: nunca instale via dnf pacotes que começam com o prefixo ea- sem usar o repositório EA4. Use sempre dnf install ea-pacote --enablerepo=EA4 para pacotes do EasyApache, e reserve o dnf padrão para utilitários do sistema. Consulte a lista de pacotes gerenciados com dnf list installed | grep ea-.

Sintoma: Composer falha com "Your requirements could not be resolved"

Causa: a extensão PHP exigida pelo pacote não está compilada no perfil EasyApache ativo para a versão PHP do domínio.
Solução: identifique a extensão faltante na mensagem de erro (ex: ext-imagick), solicite ao administrador do servidor que a instale via EasyApache 4 no WHM para a versão PHP correta. Após a instalação, execute composer install novamente.

Perguntas frequentes sobre gerenciadores de pacotes no cPanel

Onde fica o gerenciador de pacotes no cPanel?

O cPanel não possui um gerenciador de pacotes próprio para o sistema operacional — esse papel é do WHM (Web Host Manager), acessado pelo administrador do servidor. No WHM, as ferramentas EasyApache 4 e o Software Center permitem instalar, atualizar e remover módulos PHP, extensões Apache e pacotes do sistema. O usuário final do cPanel não tem acesso direto a essas funções.

Qual a diferença entre EasyApache 4 e o yum/dnf no servidor cPanel?

O EasyApache 4 é o gerenciador de perfis de compilação do Apache e PHP específico do cPanel, que instala módulos via repositórios próprios da CloudLinux/cPanel. Já o dnf (ou yum no CentOS 7) é o gerenciador de pacotes nativo do sistema operacional, usado para instalar pacotes do SO como curl, git e bibliotecas do sistema. Ambos coexistem no servidor, mas gerenciam camadas completamente diferentes — misturá-los sem cuidado pode gerar conflitos de dependência difíceis de resolver.

Posso instalar extensões PHP pelo cPanel sem acesso root?

Não diretamente. A instalação de extensões PHP no nível do servidor exige acesso root ao WHM. Porém, usuários cPanel podem instalar bibliotecas PHP via Composer no diretório da aplicação, sem necessidade de root, desde que a extensão já esteja compilada no perfil EasyApache ativo. Para extensões novas, o administrador do servidor precisa habilitá-las no WHM antes que o usuário final possa utilizá-las.

Como atualizar o PHP no cPanel sem derrubar os sites?

No WHM, acesse EasyApache 4, selecione o perfil atual e adicione a nova versão do PHP sem remover a anterior. Após salvar e provisionar, vá em MultiPHP Manager para atribuir a nova versão apenas ao domínio de teste. Valide o funcionamento e então migre os demais domínios gradualmente, evitando downtime generalizado. Essa abordagem permite rollback imediato caso algum site apresente incompatibilidade com a nova versão.

O cPanel suporta instalação de pacotes via snap ou flatpak?

Não. O cPanel é projetado para rodar em distribuições baseadas em RPM (AlmaLinux 8/9, Rocky Linux 8/9, CloudLinux) e usa dnf/yum como gerenciador de pacotes do SO. Snap e Flatpak não são suportados oficialmente e podem causar conflitos com os serviços gerenciados pelo cPanel. A instalação de software adicional deve ser feita via dnf ou pelos repositórios próprios do cPanel/WHM para garantir estabilidade e suporte.

Conclusão

Gerenciar pacotes no ecossistema cPanel exige entender claramente qual camada cada ferramenta cobre. Confundir o EasyApache 4 com o dnf, ou tentar instalar extensões PHP sem root, são os erros mais comuns que geram horas de troubleshooting desnecessário.

• Use o EasyApache 4 no WHM para tudo relacionado a versões PHP, módulos Apache e extensões PHP — nunca instale pacotes ea-* diretamente via dnf sem o repositório EA4.
• Reserve o dnf para utilitários do sistema operacional (git, curl, unzip, htop) e sempre verifique com dnf check-update antes de atualizar pacotes críticos.
• Oriente usuários sem root a usar o Composer para dependências PHP no nível da aplicação, e solicite ao administrador a habilitação de extensões faltantes via EasyApache 4.

Para uma comparação mais ampla entre os modelos de hospedagem e quando faz sentido ter acesso root completo ao servidor, veja o artigo Comparativo: Hospedagem de sites vs. VPS: qual é a melhor opção?.

Leia também

• Comparativo: Painéis de Controle WHM/cPanel vs. Plesk para VPS Linux e Servidor Dedicado
• Solucionar erro de conexão FTP no cPanel: passo a passo definitivo
• Guia para configurar subdomínio no cPanel do jeito certo

Precisa de ajuda com cPanel e gerenciamento de pacotes?

Configurar corretamente o EasyApache 4, o MultiPHP Manager e as dependências do sistema pode ser complexo, especialmente em ambientes com múltiplos domínios e versões PHP. A AviraHost oferece planos de hospedagem com cPanel já configurado e suporte técnico disponível para auxiliar na gestão do ambiente.

Conheça os planos de hospedagem com cPanel da AviraHost