Base de Conhecimento

Como usar Composer via SSH em uma hospedagem cPanel

Neste tutorial você aprenderá como usar o Composer via SSH em uma hospedagem cPanel para instalar e gerenciar dependências de projetos PHP.

1. O que é Composer?

O Composer é um gerenciador de dependências para PHP. Ele é usado para instalar bibliotecas e pacotes necessários para aplicações e sites em PHP.

2. Requisitos

Para usar Composer na hospedagem, normalmente você precisará de:

acesso SSH / Shell habilitado na conta;
um projeto PHP com arquivo composer.json;
ambiente PHP compatível com os requisitos do projeto.

A documentação do cPanel informa que, nas versões mais novas, o Composer não é mais fornecido automaticamente pelo pacote antigo do sistema. Por isso, a instalação e disponibilidade do Composer podem variar conforme o servidor.

3. Acessar a hospedagem por SSH

Conecte-se à sua conta por SSH usando o seu cliente preferido, como:

OpenSSH do Windows;
PuTTY;
MobaXterm;
Bitvise;
WinSCP para acesso a arquivos por SFTP.

4. Entrar na pasta do projeto

Após acessar a conta, navegue até a pasta do projeto PHP. Exemplo:

cd ~/public_html/meuprojeto

5. Verificar se o projeto possui composer.json

O Composer usa o arquivo composer.json para identificar as dependências do projeto.

Você pode conferir com:

ls -la

6. Instalar as dependências do projeto

Se o Composer estiver disponível no servidor, o comando mais comum para instalar as dependências é:

composer install

Se você estiver atualizando dependências já definidas no projeto, pode usar:

composer update

Use composer update com cuidado em produção, pois ele pode alterar versões de pacotes. Em muitos casos, composer install é a opção mais segura para publicar um projeto já preparado.

7. Sobre a configuração do PHP

A documentação do cPanel informa que, para usar Composer corretamente, o servidor precisa ter os módulos PHP necessários e um php.ini configurado de forma adequada para permitir a execução do Composer.

8. Se o comando não funcionar

Se o comando composer não estiver disponível, isso pode significar que:

o Composer não está instalado globalmente no servidor;
o acesso Shell da conta não está habilitado;
o ambiente PHP não está pronto para o Composer;
o administrador do servidor precisa concluir a configuração.

9. Dica final

Depois de instalar as dependências, você poderá seguir com a publicação normal do projeto, inclusive usando Git e deployment, se a aplicação estiver integrada ao Git Version Control do cPanel.

Pronto! Agora você já sabe como usar o Composer via SSH em uma hospedagem cPanel.

0 Usuários acharam útil