FW Guia Completo do Composer

História do Composer

O Composer foi criado por Nils Adermann e Jordi Boggiano e lançado em 1 de Março de 2012. Surgiu como resposta à necessidade de um gerenciador de dependências eficiente para a comunidade PHP, que até então não possuía uma ferramenta padrão para esta finalidade.

Inspirado no npm (Node.js) e no Bundler (Ruby), o Composer rapidamente se tornou o padrão de fato para gerenciamento de dependências em projetos PHP, sendo adotado por grandes frameworks como Laravel, Symfony e muitos outros.

Objetivos do Composer

O Composer foi desenvolvido com os seguintes objetivos principais:

• Gerenciar dependências de projetos PHP de forma eficiente
• Permitir a instalação e atualização de bibliotecas e frameworks
• Resolver conflitos entre versões de dependências
• Facilitar o autoloading de classes conforme o padrão PSR-4
• Promover a reutilização de código através do Packagist, seu repositório principal
• Simplificar o processo de deployment e compartilhamento de projetos

Funções do Composer

O Composer executa diversas funções essenciais para o desenvolvimento PHP moderno:

Gerenciamento de Dependências

Instala e atualiza bibliotecas necessárias para seu projeto, mantendo o controle das versões compatíveis.

Autoloading de Classes

Gera automaticamente um autoloader para as classes do projeto e suas dependências, seguindo o padrão PSR-4.

Scripts e Eventos

Permite a execução de scripts em eventos específicos como pós-instalação ou pós-atualização.

Gerenciamento de Pacotes Globais

Oferece a possibilidade de instalar ferramentas CLI globalmente no sistema.

Bibliotecas que Funcionam com Composer

Praticamente todas as bibliotecas e frameworks PHP modernos suportam o Composer. Alguns exemplos populares:

Exemplo Prático: Usando o Composer com a Biblioteca Guzzle

Vamos ver na prática como utilizar o Composer para instalar e usar uma biblioteca. Neste exemplo, usaremos o Guzzle, um cliente HTTP popular.

mkdir meu-projeto
cd meu-projeto

composer init

composer require guzzlehttp/guzzle

meu-projeto/
├── vendor/
│   ├── autoload.php
│   ├── composer/
│   └── guzzlehttp/
├── composer.json
├── composer.lock
└── (seus arquivos de projeto)

<?php
// Inclui o autoloader do Composer
require 'vendor/autoload.php';

use GuzzleHttp\Client;

// Cria uma instância do cliente Guzzle
$client = new Client();

// Faz uma requisição HTTP GET
$response = $client->request('GET', 'https://api.github.com/users/octocat');

// Exibe o código de status da resposta
echo "Status: " . $response->getStatusCode() . "\n";

// Exibe o tipo de conteúdo
echo "Tipo: " . $response->getHeaderLine('content-type') . "\n";

// Exibe o corpo da resposta
echo "Corpo: " . $response->getBody() . "\n";
?>

php exemplo.php

Status: 200
Tipo: application/json; charset=utf-8
Corpo: {"login":"octocat","id":583231,"node_id":"MDQ6VXNlcjU4MzIzMQ==",...}

{
    "name": "vendor/meu-projeto",
    "description": "Exemplo de uso do Guzzle com Composer",
    "require": {
        "guzzlehttp/guzzle": "^7.4"
    },
    "autoload": {
        "psr-4": {
            "MeuProjeto\\": "src/"
        }
    }
}

Este exemplo demonstra como o Composer simplifica o processo de adicionar e gerenciar dependências em projetos PHP. Com poucos comandos, você pode adicionar bibliotecas poderosas ao seu projeto e começar a usá-las imediatamente.

Servidores que Aceitam Composer

O Composer pode ser executado em qualquer servidor que atenda aos requisitos básicos:

• PHP 5.3.2 ou superior (recomenda-se PHP 7.0 ou superior para melhor performance)
• Extensões PHP necessárias: phar, json, zip (para descompactação)
• Permissão para execução de comandos via shell (para instalação)
• Acesso à internet para baixar pacotes (a menos que use repositórios privados)

Quanto aos provedores de hospedagem, a maioria dos serviços modernos suporta Composer, incluindo:

• Shared hosting com suporte a SSH (como HostGator, BlueHost, etc.)
• VPS e servidores dedicados
• Plataformas de cloud (AWS, Google Cloud, Azure, DigitalOcean)
• Servidores de desenvolvimento local (XAMPP, WAMP, MAMP, Laragon)

Composer é Gratuito?

Sim, o Composer é completamente gratuito e de código aberto. Ele é distribuído sob a licença MIT, que permite uso comercial, modificação, distribuição e uso privado sem quaisquer custos.

O Packagist, o repositório principal do Composer, também é gratuito para uso público. Para pacotes privados, existem serviços pagos como Private Packagist, mas o Composer em si não tem custos.

Capacidade do Composer

O Composer é capaz de gerenciar projetos de qualquer tamanho, desde pequenos scripts até grandes aplicações empresariais com centenas de dependências.

Limites Práticos

• Não há limite teórico para o número de pacotes gerenciados
• O desempenho pode variar conforme a complexidade das dependências
• Projetos muito grandes podem exigir mais memória durante a instalação

Otimizações

Para projetos maiores, o Composer oferece otimizações como:

• Instalação seletiva de dependências (--prefer-dist)
• Otimização de autoloader (--optimize-autoloader)
• Modo de instalação preferencial (--prefer-source ou --prefer-dist)

Arquivos Controlados pelo Composer

O Composer utiliza principalmente dois arquivos para gerenciar as dependências do projeto:

composer.json

Arquivo de configuração onde você define:

• Dependências do projeto
• Scripts personalizados
• Repositórios adicionais
• Configurações de autoload
• Requisitos do sistema (versão do PHP, extensões necessárias)

Exemplo de composer.json:

{
    "name": "vendor/project",
    "description": "My project",
    "type": "project",
    "require": {
        "php": "^7.4|^8.0",
        "laravel/framework": "^8.0"
    },
    "autoload": {
        "psr-4": {
            "App\\": "app/",
            "Database\\Factories\\": "database/factories/",
            "Database\\Seeders\\": "database/seeders/"
        }
    }
}
            

composer.lock

Arquivo gerado automaticamente que registra as versões exatas instaladas. Isso garante que todas as instalações futuras usarão as mesmas versões, garantindo consistência entre ambientes.

Comandos para Terminal

Principais comandos do Composer para uso no terminal:

Onde Usar o Composer

O Composer pode ser utilizado em diversos ambientes e cenários:

Desenvolvimento Local

Em máquinas de desenvolvimento, instalado globalmente para criar e manter projetos PHP.

Servidores de Produção

Para deploy de aplicações, instalando dependências diretamente no servidor ou através de integração contínua.

Integração Contínua/CI

Em pipelines de CI/CD para instalar dependências antes de executar testes ou deploy.

Contêineres Docker

Dentro de contêineres Docker para gerenciar dependências de aplicações PHP.

Composer no DirectAdmin

Para usar o Composer no DirectAdmin, siga estes passos:

1. Acesse via SSH

Use o acesso SSH fornecido pelo seu host para conectar ao servidor.

2. Instale o Composer

Execute os seguintes comandos:

cd /usr/local/bin
curl -sS https://getcomposer.org/installer | php
mv composer.phar composer
chmod +x composer
            

3. Use em seu projeto

Navegue até a pasta do seu projeto e execute os comandos do Composer:

cd /domains/seudominio.com/public_html
composer install
            

Nota: Alguns hosts podem exigir que você use uma versão específica do PHP. Nesse caso, use php7.4 /usr/local/bin/composer install (substitua 7.4 pela versão desejada).

Usando Composer com PuTTY

O PuTTY é um cliente SSH para Windows que permite acessar servidores remotos. Para usar o Composer via PuTTY:

1. Conecte-se ao servidor

Abra o PuTTY, digite o endereço do servidor e faça login com suas credenciais.

2. Navegue até o diretório do projeto

Use comandos como cd para navegar até a pasta do seu projeto.

3. Execute comandos do Composer

Digite os comandos do Composer normalmente, por exemplo:

composer install
composer update
composer require vendor/package
            

Tipo de Acesso Necessário

Para executar o Composer via PuTTY, você precisa de:

• Acesso SSH ao servidor
• Permissões para executar comandos (geralmente usuário com privilégios normais é suficiente)
• Permissão de escrita no diretório do projeto