Base de Conhecimento

Alguns clientes podem encontrar erros ao usar o comando composer no SSH da hospedagem. Isso acontece porque o Composer precisa ser executado usando a mesma versão do PHP configurada na sua conta.

Este tutorial mostra como resolver o problema de forma simples, alterando um arquivo chamado .bashrc.

Antes de começar

IMPORTANTE! O arquivo .bashrc é um arquivo oculto. Se ele não estiver visível no Gerenciador de Arquivos do cPanel, siga primeiro este tutorial:

Como exibir arquivos ocultos (.htaccess) no Gerenciador de Arquivos do cPanel

Passo 1 – Abrir o Gerenciador de Arquivos

1. Acesse o cPanel da sua hospedagem.
2. Clique em Gerenciador de Arquivos.
3. Clique na pasta raiz/principal da hospedagem, um nível antes da pasta public_html.
4. Não entre na pasta public_html.

Passo 2 – Localizar o arquivo .bashrc

1. Procure pelo arquivo chamado .bashrc.
2. Clique com o botão direito do mouse no arquivo .bashrc e depois clique em Editar.

Passo 3 – Adicionar a configuração do Composer

Dentro do arquivo .bashrc adicione a seguinte linha no final do conteúdo:

alias composer='/opt/alt/php82/usr/bin/php /opt/cpanel/composer/bin/composer'

Atenção: Substitua o número 82 pela versão do PHP que você utiliza na hospedagem.

Exemplos:

• PHP 7.4:

  alias composer='/opt/alt/php74/usr/bin/php /opt/cpanel/composer/bin/composer'

• PHP 8.1:

  alias composer='/opt/alt/php81/usr/bin/php /opt/cpanel/composer/bin/composer'

• PHP 8.3:

  alias composer='/opt/alt/php83/usr/bin/php /opt/cpanel/composer/bin/composer'

Após inserir a linha corretamente, clique em Salvar Alterações.

Passo 4 – Testar o Composer

1. Acesse o SSH da sua hospedagem.
2. Digite o comando abaixo e pressione Enter:

composer --version

Se estiver tudo correto, o sistema irá mostrar a versão do Composer instalada.

Resultado esperado

• O comando composer funcionará normalmente no SSH
• O Composer usará a versão correta do PHP da sua hospedagem
• Não será mais necessário informar o caminho completo do Composer

Observações importantes

• Se você trocar a versão do PHP no futuro, será necessário atualizar essa linha no arquivo .bashrc.
• Se o comando não funcionar de imediato, feche o SSH e abra novamente.