Que é Composer para PHP, características e como usalo

Composer é unha ferramenta de xestión de dependencias de código aberto para PHP, creada principalmente para facilitar a implantación e mantemento de paquetes PHP como compoñentes individuais de aplicacións.

O Composer cambiou radicalmente o ecosistema PHP, creando a base para a evolución do PHP moderno, é dicir, aplicacións e marcos baseados en compoñentes.

características

Os requisitos decláranse nun ficheiro JSON a nivel de proxecto, que Composer usa despois para avaliar que versións do paquete se adaptan mellor ás dependencias da aplicación. A avaliación considerará as dependencias anidadas e os requisitos do sistema, se os houber.

É importante ter en conta que Composer permítelle instalar as bibliotecas necesarias por proxecto. Permítelle usar diferentes versións da mesma biblioteca en diferentes proxectos PHP.

Para instalar e utilizar bibliotecas xestionadas por compositor, terás que declaralos no proxecto nun formato estándar e Composer encargarase do resto. Por exemplo, se queres instalar a biblioteca mpdf usando Composer, debes executar o seguinte comando na raíz do teu proxecto.

$composer require mpdf/mpdf

Pero de onde descarga o Composer as bibliotecas?

que bibliotecas hai dispoñibles?

Hai un repositorio central onde compositor mantén unha lista de bibliotecas dispoñibles: o Packagist.

Instalación

Agora vexamos como instalar Composer en sistemas operativos como Linux, macOS e Windows.

Instalación: Linux / Unix / maxOS

Para instalar Composer en linux, unix e macOS, debes descargar o instalador en https://getcomposer.org/doc/00-intro.md#installation-linux-unix-macos e instálao localmente como parte do seu proxecto ou globalmente como un executable de todo o sistema.

O instalador comprobará algunhas configuracións de PHP e descargará un ficheiro chamado composer.phar no seu directorio de traballo. Este é o binario de Composer. É un PHAR (arquivo PHP), que é un formato de arquivo para PHP que se pode executar dende a liña de comandos, entre outras cousas.

php composer.phar

instalación - Windows

Para instalar Composer en Windows, debes descargar o instalador en https://getcomposer.org/doc/00-intro.md#installation-windows

Unha vez completada a instalación, pode comprobar que funciona correctamente co comando

composer -V

e deberías ter unha resposta coma esta

Paquetista

Paquetista, o repositorio público de compositor, contén unha colección de bibliotecas PHP de código aberto dispoñible gratuitamente a través de Composer. Unha versión premium do servizo ofrece hospedaxe para paquetes privados, o que permite usar Composer mesmo en proxectos de código pechado.

Hai centos de bibliotecas dispoñibles en Packagist, o que mostra a popularidade de Composer. Nos teus proxectos PHP, se necesitas unha función que pensas que xa debería estar dispoñible como biblioteca de terceiros, Packagist é o primeiro lugar no que debes buscar.

Ademais do Packagist, podes pedirlle ao Composer que busque outros repositorios para a instalación da biblioteca cambiando a clave dos repositorios no ficheiro composer.json. De feito, isto é o que fará se quere xestionar os seus paquetes privados de Composer.

Como usar compositor

Hai dúas formas de instalar bibliotecas con Composer. Vémolos os dous:

O comando de instalación

Para usar o instalador, primeiro debes crear un ficheiro composer.json no teu proxecto. No ficheiro composer.json, só tes que declarar as dependencias do teu proxecto, como se mostra no fragmento a continuación.

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

Máis tarde, cando executa o comando de instalación de composer, no mesmo cartafol onde está o ficheiro json, Composer instala o paquete mpdf e as súas dependencias no directorio do provedor.

O comando require

Podemos dicir que o comando composer require é unha especie de atallo para realizar o proceso anterior de creación dun ficheiro composer.json. require engadirá automaticamente un paquete ao teu ficheiro composer.json. O seguinte comando mostra como instalar o paquete mpdf coa axuda de require.

$composer require mpdf/mpdf

Despois de instalar o paquete mpdf e as súas dependencias, require tamén engade unha entrada do paquete que se está instalando no ficheiro composer.json. Se o ficheiro composer.json non existe, crearase sobre a marcha.

Ercole Palmeri