Composer es un manejador de paquetes para PHP que proporciona un estándar para administrar, descargar e instalar dependencias y librerías. Similar a NPM en Node.js y Bundler en Ruby, Composer es la solución ideal cuando trabajamos en proyectos complejos que dependen de múltiples fuentes de instalación. En lugar de tener que descargar cada dependencia de forma manual, Composer hace esto de forma automática por nosotros.
Instalación de composer
Si te encuentras en Windows simplemente tienes que descargar el
Para ejecutar Composer simplemente escribe el comando composer en la terminal y presiona Enter, verás algo como esto:
Comandos y argumentos composer
Como puedes observar en la imagen, Composer tiene una lista de comandos y argumentos que nos permiten realizar diferentes tareas. Vamos a detallar y describir los comandos más importantes, uno por uno:
$ composer init
Al ejecutar este comando solicitará cierta información que servirá para crear el archivo composer.json.
$ 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 sólo quieres actualizar una dependencia en específico, para hacer eso tienes que indicar el nombre del paquete de la siguiente manera:
Esto sólo 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, sólo 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 carácter mal escrito, podemos utilizar el comando valídate 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.
# Resultado de ejecutar composer status -v
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.
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: