Como Instalar PHP Composer em Hospedagem Compartilhada/Virtual: Um Guia Completo

PHP Composer é o gerenciador de dependências de facto para PHP, permitindo que os desenvolvedores declarem, instalem e gerenciem as bibliotecas das quais seus projetos dependem. Quer você esteja construindo uma aplicação Laravel, uma API Symfony ou um projeto PHP personalizado, Composer é uma ferramenta indispensável no seu fluxo de trabalho.

Este guia abrangente o orienta em cada etapa da instalação do PHP Composer em um ambiente de hospedagem virtual ou compartilhada — desde o acesso SSH até a configuração global e o uso no mundo real.

O que é PHP Composer e por que você precisa dele?

PHP Composer é um gerenciador de pacotes que lida com gerenciamento de dependências no nível do projeto. Em vez de baixar manualmente bibliotecas e gerenciar o carregamento automático, Composer resolve dependências automaticamente, baixa as versões corretas e gera um carregador automático otimizado.

Os principais benefícios incluem:

• Resolução automática de dependências — Composer lida com conflitos de versão e dependências aninhadas.
• Compilações reproduzíveis — O arquivo composer.lock garante que cada membro da equipe e ambiente de implantação use versões de pacote idênticas.
• Ecossistema vasto — Acesso a mais de 350.000 pacotes no Packagist, o repositório padrão do Composer.
• Carregamento automático PSR-4 — Elimina instruções require e include manuais em toda a sua base de código.

Se você está executando aplicações PHP em Hospedagem Web Compartilhada ou em um ambiente de Hospedagem VPS, instalar Composer é um dos primeiros passos para um fluxo de trabalho de desenvolvimento profissional e sustentável.

Pré-requisitos

Antes de começar, confirme se os seguintes requisitos são atendidos:

> Nota: Se você estiver em um plano de hospedagem compartilhada gerenciada sem acesso SSH, entre em contato com seu provedor de hospedagem para habilitá-lo. Os planos de Hospedagem Web Compartilhada da AlexHost incluem acesso SSH, oferecendo o controle que você precisa.

Passo 1: Conectar ao seu servidor via SSH

Abra seu aplicativo de terminal e estabeleça uma conexão SSH com sua conta de hospedagem:

ssh username@yourdomain.com

Substitua username pelo seu nome de usuário SSH real e yourdomain.com pelo seu nome de domínio ou endereço IP do servidor.

Exemplo:

ssh john@203.0.113.45

Após a autenticação, você chegará ao seu diretório inicial (normalmente /home/username/). Você pode confirmar sua localização atual com:

pwd

Passo 2: Verificar se o PHP está disponível

Antes de baixar Composer, confirme se PHP está instalado e acessível a partir da linha de comando:

php -v

Você deve ver uma saída semelhante a:

PHP 8.2.10 (cli) (built: Sep  5 2023 08:15:22) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.10, Copyright (c) Zend Technologies

Se PHP não for encontrado ou a versão for inferior a 7.2, entre em contato com seu provedor de hospedagem ou atualize seu ambiente. Os usuários em um plano de Hospedagem VPS têm controle total para instalar ou atualizar versões do PHP conforme necessário.

Também verifique se as extensões necessárias estão carregadas:

php -m | grep -E 'openssl|phar|mbstring|json'

Todas as quatro extensões devem aparecer na saída.

Passo 3: Baixar o instalador do Composer

Composer fornece um script instalador oficial baseado em PHP. Baixe-o usando o seguinte comando:

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

Isso baixa o script instalador composer-setup.php para seu diretório de trabalho atual.

Passo 4: Verificar a integridade do instalador

Esta etapa é crítica para a segurança. Sempre verifique o hash SHA-384 do instalador antes de executá-lo para garantir que o arquivo não foi adulterado ou corrompido durante o download.

4a. Busque o hash esperado na página oficial de Chaves Públicas do Composer:

Visite https://composer.github.io/pubkeys.html para recuperar o hash do instalador mais recente.

4b. Execute o comando de verificação:

HASH="$(php -r "echo hash_file('sha384', 'composer-setup.php');")"

Em seguida, compare-o com o hash publicado:

php -r "if (hash_file('sha384', 'composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

Se você vir “Installer verified”, prossiga. Se você vir “Installer corrupt”, pare imediatamente, delete o arquivo e baixe-o novamente.

Alternativamente, você pode usar o comando de uma linha da documentação oficial do Composer, substituindo EXPECTED_HASH pelo valor da página de chaves públicas:

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

Passo 5: Executar o instalador do Composer

Com o instalador verificado, execute-o para instalar Composer:

php composer-setup.php

Após a execução bem-sucedida, você verá uma saída como:

All settings correct for using Composer
Downloading...

Composer (version 2.x.x) successfully installed to: /home/username/composer.phar
Use it: php composer.phar

Um arquivo composer.phar agora é criado no seu diretório atual. Neste estágio, você já pode usar Composer chamando php composer.phar, mas torná-lo globalmente acessível é muito mais conveniente.

Passo 6: Limpar o script do instalador

Remova o script de configuração, pois não é mais necessário:

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

Passo 7: Instalar Composer globalmente

Para executar Composer de qualquer lugar do seu sistema usando apenas o comando composer, mova o binário composer.phar para um diretório incluído no seu $PATH do sistema.

Em um VPS ou Servidor Dedicado (com acesso sudo):

sudo mv composer.phar /usr/local/bin/composer
sudo chmod +x /usr/local/bin/composer

Em Hospedagem Compartilhada (sem acesso sudo):

Se você não tiver privilégios sudo, instale Composer localmente dentro do seu diretório inicial:

mkdir -p ~/bin
mv composer.phar ~/bin/composer
chmod +x ~/bin/composer

Em seguida, adicione ~/bin ao seu $PATH anexando a seguinte linha ao seu ~/.bashrc ou ~/.bash_profile:

export PATH="$HOME/bin:$PATH"

Recarregue a configuração do shell:

source ~/.bashrc

> Dica profissional: Se você precisar de acesso root completo e maior controle sobre seu ambiente PHP, considere fazer upgrade para um plano de Hospedagem VPS ou um Servidor Dedicado para configuração irrestrita no nível do sistema.

Passo 8: Verificar a instalação

Confirme se Composer está instalado e acessível globalmente:

composer --version

Saída esperada:

Composer version 2.x.x 2024-xx-xx xx:xx:xx

Para um diagnóstico completo do seu ambiente, execute:

composer diagnose

Este comando verifica sua configuração PHP, conectividade de rede e configurações do Composer, relatando qualquer problema potencial.

Passo 9: Usar Composer para gerenciar dependências PHP

Agora que Composer está instalado, aqui está como usá-lo efetivamente em seus projetos PHP.

9a. Inicializar um novo projeto

Navegue até seu diretório de projeto e inicialize um novo projeto Composer:

cd /path/to/your/project
composer init

O assistente interativo solicitará:

• Nome do pacote (por exemplo, yourname/project)
• Descrição
• Informações do autor
• Estabilidade mínima
• Dependências necessárias

Isso gera um arquivo composer.json — o coração da configuração de dependência do seu projeto.

9b. Instalar um pacote

Para adicionar uma biblioteca ao seu projeto, use o comando require:

composer require vendor/package-name

Exemplos do mundo real:

# Install Guzzle HTTP client
composer require guzzlehttp/guzzle

# Install Carbon date library
composer require nesbot/carbon

# Install Monolog logging library
composer require monolog/monolog

Composer resolverá dependências, baixará os pacotes para o diretório vendor/ e atualizará composer.json e composer.lock.

9c. Instalar todas as dependências do composer.json

Ao implantar um projeto ou clonar um repositório, instale todas as dependências declaradas com:

composer install

Para ambientes de produção, use a flag --no-dev para pular pacotes apenas de desenvolvimento:

composer install --no-dev --optimize-autoloader

9d. Atualizar dependências

Para atualizar todos os pacotes para suas versões permitidas mais recentes:

composer update

Para atualizar um pacote específico:

composer update vendor/package-name

9e. Carregamento automático

Composer gera automaticamente um carregador automático. Inclua-o no topo do seu ponto de entrada PHP:

<?php
require 'vendor/autoload.php';

Esta única linha oferece acesso a todos os pacotes instalados e a qualquer namespace personalizado que você defina em composer.json.

Solução de problemas comuns

Manter Composer atualizado

Composer inclui um mecanismo de auto-atualização integrado. Execute o seguinte comando periodicamente para garantir que você tenha a versão mais recente:

composer self-update

Para reverter para a versão anterior, se necessário:

composer self-update --rollback

Manter-se atualizado garante que você se beneficie dos patches de segurança mais recentes, correções de bugs e melhorias de desempenho.

Escolher o ambiente de hospedagem correto para desenvolvimento PHP

O ambiente de hospedagem que você escolhe impacta significativamente sua capacidade de usar ferramentas como Composer efetivamente.

• Hospedagem Web Compartilhada — Adequada para projetos PHP menores. O acesso SSH está disponível, mas as mudanças no nível do sistema são restritas. Composer pode ser instalado localmente no seu diretório inicial.

• Hospedagem VPS — Ideal para a maioria dos desenvolvedores PHP. O acesso root completo permite instalação global do Composer, configurações PHP personalizadas e controle completo sobre sua stack.

• VPS com cPanel