O que é o Composer para PHP, recursos e como usá-lo

O Composer é uma ferramenta de gerenciamento de dependência de software livre para PHP, criada principalmente para facilitar a implantação e manutenção de pacotes PHP como componentes de aplicativos individuais.

O Composer mudou radicalmente o ecossistema PHP, criando a base para a evolução do PHP moderno, ou seja, aplicativos e frameworks baseados em componentes.

Características

Os requisitos são declarados em um arquivo JSON no nível do projeto, que o Composer usa para avaliar quais versões do pacote correspondem melhor às dependências do aplicativo. A avaliação considerará dependências aninhadas e requisitos do sistema, se houver.

É importante observar que o Composer permite que você instale as bibliotecas necessárias por projeto. Ele permite que você use diferentes versões da mesma biblioteca em diferentes projetos PHP.

Para instalar e usar bibliotecas gerenciadas por Compor, você terá que declará-los no projeto em um formato padrão e o Composer cuidará do resto. Por exemplo, se você deseja instalar a biblioteca mpdf usando o Composer, você precisa executar o seguinte comando na raiz do seu projeto.

$composer require mpdf/mpdf

Mas de onde o Composer baixa as bibliotecas?

quais bibliotecas estão disponíveis?

Existe um repositório central onde Compor mantém uma lista de bibliotecas disponíveis: o Packagist.

Instalação

Agora vamos ver como instalar o Composer em sistemas operacionais como Linux, macOS e Windows.

Instalação – Linux / Unix / maxOS

Para instalar o composer no linux, unix e macOS, você precisa baixar o instalador em https://getcomposer.org/doc/00-intro.md#installation-linux-unix-macos e instale-o localmente como parte de seu projeto ou globalmente como um executável de todo o sistema.

O instalador verificará algumas configurações do PHP e baixará um arquivo chamado composer.phar em seu diretório de trabalho. Este é o binário do Composer. É um PHAR (arquivo PHP), que é um formato de arquivo para PHP que pode ser executado a partir da linha de comando, entre outras coisas.

php composer.phar

Instalação - Windows

Para instalar o composer no Windows, você precisa baixar o instalador em https://getcomposer.org/doc/00-intro.md#installation-windows

Uma vez concluída a instalação, você pode verificar se funciona corretamente com o comando

composer -V

e você deve ter uma resposta como esta

Empacotador

Empacotador, o repositório público de Compor, contém uma coleção de bibliotecas PHP open source disponibilizados gratuitamente através do Composer. Uma versão premium do serviço oferece hospedagem para pacotes privados, possibilitando o uso do Composer mesmo em projetos de código fechado.

Existem centenas de bibliotecas disponíveis no Packagist, o que mostra a popularidade do Composer. Em seus projetos PHP, se você precisar de um recurso que acha que já deveria estar disponível como uma biblioteca de terceiros, o Packagist é o primeiro lugar que você deve procurar.

Além do Packagist, você pode pedir ao Composer para procurar outros repositórios para instalação de biblioteca alterando a chave de repositórios no arquivo composer.json. Na verdade, isso é o que você fará se quiser gerenciar seus pacotes privados do Composer.

Como usar o compositor

Existem duas maneiras de instalar bibliotecas com o Composer. Vejamos os dois:

O comando de instalação

Para usar o instalador, você deve primeiro criar um arquivo composer.json em seu projeto. No arquivo composer.json, basta declarar as dependências do seu projeto, conforme o trecho abaixo.

{
    "require": {
        "mpdf/mpdf": "~6.1"
    }
}

Posteriormente, ao executar o comando composer install, na mesma pasta onde está o arquivo json, o Composer instala o pacote mpdf e suas dependências no diretório vendor.

O comando requer

Podemos dizer que o comando composer require é uma espécie de atalho para realizar o processo anterior de criação de um arquivo composer.json. require adicionará automaticamente um pacote ao seu arquivo composer.json. O comando a seguir mostra como instalar o pacote mpdf com a ajuda de require.

$composer require mpdf/mpdf

Depois de instalar o pacote mpdf e suas dependências, require também adiciona uma entrada do pacote que está sendo instalado no arquivo composer.json. Se o arquivo composer.json não existir, ele será criado na hora.

Ercole Palmeri