dedicadobackuplogin

Como instalar o Composer no cPanel (versão 130 ou superior): guia completo

Instalação do Composer no cPanel

O Composer é uma ferramenta amplamente utilizada para gerenciar dependências no PHP. No entanto, a partir da versão 130 do cPanel, ele não vem mais pré-instalado por padrão, fazendo parte do Plano de Descontinuação do cPanel. Isso significa que, se você precisa dessa funcionalidade, será necessário instalar manualmente — e é exatamente isso que vamos explicar aqui.

Pré-requisitos para instalar o Composer no cPanel

  • Acesso root via SSH ou terminal no WHM;
  • allow_url_fopen ativado no PHP.

Como verificar e habilitar o allow_url_fopen

O allow_url_fopen permite que o PHP acesse arquivos remotos via funções como file_get_contents(). O Composer depende disso para baixar pacotes e o próprio instalador. Para verificar se ele está ativo:

  1. Acesse o WHM ou o cPanel como root.
  2. Vá até Software > MultiPHP INI Editor.
  3. Escolha a versão do PHP usada no terminal/SSH.
  4. Procure pela diretiva allow_url_fopen e verifique se está como On.

Se estiver Off, altere para On, salve as mudanças e reinicie o Apache ou PHP-FPM, conforme a configuração do servidor.

Passo 1: Baixar e verificar o instalador do Composer

Baixe o Instalador

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

Em seguida, baixe a chave de assinatura mais recente do Composer na página do Composer no GitHub, que é usada para validar se o instalador é válido:

php -r "copy('https://composer.github.io/installer.sig', 'composer.sig');"

Com isso instalado, verifique se o instalador do Composer é válido. Ele usa a assinatura mais recente do instalador baixada como “composer.sig” na etapa anterior. A mensagem será “Instalador verificado” ou “Instalador corrompido“:

php -r "if (hash_file('sha384', 'composer-setup.php') === trim(file_get_contents('composer.sig'))) { echo 'Installer verified'.PHP_EOL; } else { echo 'Installer corrupt'.PHP_EOL; unlink('composer-setup.php'); exit(1); }"

Esses comandos baixam o instalador e verificam a integridade para evitar arquivos corrompidos ou adulterados.

Passo 2: Instalar e mover o Composer

php composer-setup.php
mv -v composer.phar /usr/local/bin/composer

Ao mover para /usr/local/bin/, o Composer fica disponível globalmente no servidor.

Passo 3: Limpar arquivos temporários

php -r "unlink('composer-setup.php'); unlink('composer.sig');"

Boa prática para manter o servidor organizado e seguro.

Passo 4: Ajuste para CloudLinux com CageFS

Se seu servidor utiliza CloudLinux com CageFS, siga também:

touch /etc/cagefs/conf.d/composer.cfg
# Adicione:
[composer]
comment=Composer
paths=/usr/local/bin/composer
# Depois execute:
cagefsctl --force-update

Importante: Composer e o plano de descontinuação do cPanel

O cPanel removeu o Composer de sua instalação padrão como parte de seu plano de descontinuação. Isso significa que, embora você ainda possa instalá-lo manualmente, ele não é mais suportado oficialmente pelo cPanel.

Essa mudança faz parte de um processo regular de descontinuação de pacotes, visando manter o sistema mais leve e seguro. Administradores que dependem do Composer devem se preparar para manter e atualizar a ferramenta por conta própria.

Testando a instalação

Para confirmar que tudo está funcionando, execute:

composer --version

Se a versão aparecer, o Composer está pronto para uso.

Conclusão

Embora o Composer tenha sido removido da instalação padrão do cPanel, a configuração manual continua viável e confiável. Ao ativar o allow_url_fopen, seguir os passos de instalação e compreender o motivo de sua descontinuação, você garante que seu servidor PHP continue atendendo projetos modernos sem abrir mão do controle tradicional.