composer

µFramework desde cero

Composer y más...

Dándole continuidad al desarrollo de nuestro proyecto, ya que en la ultima entrega dejamos en la creación de la estructura de carpetas, para poder realizar esta clase necesitamos crear un archivo dentro de la carpeta public/index.php, el cual sera el punto de entrada a nuestro framework, pero primero pongámonos en contexto.

Qué es Composer y cómo usarlo

¿Así que no sabes qué es Composer? A mi también me pasó cuando empecé a desarrollar profesionalmente en PHP, no entendía que era Composer, no entendía porqué necesitaba instalar eso en mi computadora, para qué era necesario, que era eso de “vendor”, ¿Composer.json? En esta sección te explicaré todos esos puntos que una vez trataron de complicarme la existencia.

El asunto está así: PHP ha tenido algunos cuantos problemas en el mundo de la descarga de paquetes/librerías, para hacer eso tenías que ir a la web (si es que tenía) de alguna librería y buscar la sección de “Descargas” para poder utilizarla; sin contar con el hecho que para hacer eso en algunas ocasiones necesitabas registrarte a la página; programadores PHP se quejaban de que no existía algo como npm para Node.js o bundler para Ruby. Bien, ahora existe, se llama Composer y podría considerarse una de las maravillas del mundo de PHP.

Composer es un manejador de dependencias.

– ¿Manejador de qué?

Composer es un manejador de dependencias, no un gestor de paquetes. Pero es cierto que trata con paquetes y librerías, la instalación puede ser local para cualquier proyecto o global para ser accedido desde cualquier lugar de nuestra computadora, las librerías se instalan en un directorio por defecto (normalmente es /vendor). Composer es capaz de instalar las librerías que requiere tu proyecto con las versiones que necesiten. ¿Y si mis librerías dependen de otras? También es capaz de resolver eso y descargar todo lo necesario para que funcione y así quitarnos del dolor de cabeza de hacer todo eso de forma manual.

¿Qué problemas resuelve Composer?

Tienes un proyecto que depende de ciertas librerías desarrolladas por terceros, y a su vez, éstas librerías también dependen de otras (tú no tienes porqué conocer estas librerías), lo que hace Composer en este caso es averiguar que librerías deben instalarse; es decir, resuelve todas las dependencias indirectas y descarga automáticamente la versión correcta de cada paquete.

En https://packagist.com puedes ver todo los paquetes privados (de pago) que hay disponibles con Composer y en https://packagist.org los que son gratuitos.

¿Cómo instalo Composer?

La instalación de Composer es muy sencilla, si estás en Linux o Mac es sólo ejecutar dos comandos en la terminal:

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

El primer comando descarga Composer a tu computador y el segundo lo mueve al directorio para que lo puedas ejecutar globalmente usando $ composer desde cualquier carpeta, de lo contrario necesitarías siempre referenciar al archivo con la ruta completa, por ejemplo algo como: ~/Downloads/composer.phar.

Y si estás en Windows, tienes un instalador de Composer ejecutable. No, no es un virus. Aquí tienes las instrucciones detalladas para instalar Composer en tu plataforma favorita.

Comandos disponibles con Composer

Si eres un programador Ruby entonces debes de estar familiarizado con el archivo Gemfile, o si eres de Node.js con package.json; bueno, estos son los comandos que puedes utilizar con composer:

$ composer about
$ composer archive
$ composer browse
$ composer clear-cache
$ composer config --list
$ composer create project laravel/laravel
$ composer depends vendor/package
$ composer diagnose
$ composer dump-autoload --optimization
$ composer global
$ composer help
$ composer init
$ composer install
$ composer licenses
$ composer list
$ composer remove
$ composer require vendor/package
$ composer run-script
$ composer search my keywords
$ composer self-update
$ composer show
$ composer status
$ composer update
$ composer validate

Ahora explicaré brevemente algunos comandos.

$ composer init

Al ejecutar este comando solicitará cierta información que servirá para crear el archivo composer.json, este lo explicaré más adelante con mas detalle para una mejor compresión, solo mencionaré que la información requerida es básica para el archivo, como el nombre del paquete/proyecto, descripción, autor(es), página del proyecto, y las dependencias. No te preocupes, más adelante te explicaré detalladamente qué es cada uno de estos datos.

$ composer install

Este comando procesa el archivo composer.json y resuelve las dependencias, normalmente las instala en un directorio llamado /vendor, pero podemos especificar cualquier otro.

$ composer update

Actualiza las dependencias de tu proyecto a la última versión y también actualiza el archivo composer.lock Esto se puede hacer de varias maneras, imagina que solo quieres actualizar un dependencia en específico, para hacer eso tienes que indicar el nombre del paquete, de la siguiente manera:

$ composer update vendor/package another-vendor/another-package vendor-x/package-x

Esto solo actualizará las dependencias especificadas, si quieres actualizar todas las dependencias de un cierto paquete puede ahorrar muchos caracteres utilizando un comodín *, de la siguiente manera:

$ composer update vendor-x/*

El comando require instala las dependencias especificadas, este lo explicaré más detalladamente en el siguiente tutorial, la sintaxis es la siguiente:

$ composer require vendor/package:*

El comando search busca el paquete indicado en Packagist, solo tienes que pasarle el nombre del paquete.

$ php composer search monolog

El comando show muestra los paquetes disponibles y también puedes ver los detalles de un paquete en específico. Basta con pasarle un argumento, este tiene que ser el nombre del paquete:

$ php composer show vendor/package

Desplegará información como: el nombre del paquete, versiones, el tipo de paquete, el código fuente, el zip del código fuente, licencia, etc.

El comando depends muestra la lista de paquetes de los cuales depende el paquete indicado. Sí, me estoy refiriendo a las librerías de terceros. Muestra los paquetes de tipo require y require-dev

$ php composer depends vendor/package

Para asegurarnos que nuestro archivo composer.json está escrito correctamente y que alguno no tendrá errores al descargarlo y tampoco tener problemas al instalar las dependencias, como algún caracter mal escrito, podemos utilizar el comando validate para verificar que todo está correctamente bien.

$ php composer validate

Si a menudo realizas cambios en tus dependencias y las has instalado mediante el código fuente del repositorio, el comando status te permite comprobar si has hecho cambios en alguna de ellas, así como el git status nos indica qué archivos hemos modificado, este comando funciona de la misma manera:

$ php composer status -v

Si añadimos la opción -v nos brinda información más detallada sobre los cambios producidos. You have changes in the following dependencies: vendor/seld/jsonlint: M README.mdown

El comando self-update actualiza el propio Composer a la versión más reciente, no tienes que realizar ningún otro paso más escribir en la consola lo siguiente:

$ php composer self-update

Y listo, tendrás disponible la versión más actualizada del manejador. ¿Lindo, no?

El comando config te permite editar varias opciones de Composer, tanto en el archivo local del proyecto como en el archivo global.

$ php composer config --list

El comando create-project crea un nuevo proyecto, es necesario pasar como parámetros el vendor y package correspondiente. Esto es lo mismo que descargar el proyecto y después ejecutar el archivo composer.json que venga en él, el siguiente ejemplo crea un proyecto de laravel.

$ php composer create-project laravel/laravel mi-proyecto

Ahora, si necesitas actualizar tu archivo autoloader porque tienes nuevas clases puedes hacerlo con el comando dump-autoload, es como ejecutar install o update, pero la ventaja es que puedes especificar que se cree un arreglo de todas las clases del proyecto con sus respectivos archivos, de la siguiente manera:

$ php composer dump-autoload --optimize

El comando run-script permite ejecutar manualmente alguno de los scripts definidos por algún paquete.

$ php composer run-script nombre-script --no-dev

Hemos agregado –no-dev para desactivar el modo de desarrollo.

Utiliza el comando help para ver información sobre el comando solicitado.

$ php composer help install

El comando remove sirve para eliminar alguna dependencia que ya no utilicemos, de la siguiente manera:

$ php composer remove vendor/package

Ahora que ya sabe -que es y como funciona Composer- creo que llego la hora en la que empecemos de lleno a vincular todos las bases antes comprendidas y unirlas para poder darle la vida necesaria a nuestro micro-framework, para ello no se pierdan la siguiente sección.