Cómo Instalar y Usar Composer – Tutorial Completo

En este artículo, te mostraremos cómo instalar y usar Composer en varias plataformas. Composer es un administrador de dependencias para PHP. Es una herramienta simple y confiable que los desarrolladores usan para administrar e integrar paquetes o bibliotecas externas en sus proyectos basados en PHP. De esta manera, no tienen que crear sus páginas web o aplicaciones web desde cero.

Para ayudarte a dominar esta herramienta, también aprenderás cómo crear un proyecto PHP básico.

Antes de aprender cómo instalar Composer, asegúrese de tener acceso a la interfaz de línea de comandos en su sistema o servidor.

Instalando Composer

Lo primero y lo más fácil de este tutorial es instalar Composer en tu sistema. Aquí puedes encontrar la guía de instalación tanto para Windows como para Linux. Los usuarios de Mac solo tienen que abrir la terminal y seguir los mismos pasos que para Linux.

1. Instalar Composer en un hosting compartido, Linux o macOS

Los comandos para instalar Composer en hosting compartido, Linux (PC o servidor) y macOS son los mismos.

Composer ahora está pre-instalado en los planes de hosting web Premium y Empresarial de Hostinger. Si usas un hosting compartido, puedes saltarte esta parte. Sin embargo, si descubres que está desactualizado, puedes actualizar Composer ejecutando este comando: 

php composer.phar self-update

Sigue estas instrucciones para saber cómo instalar Composer en tu sistema:

1. Conéctate a su cuenta de hosting utilizando la conexión SSH. Puedes aprender cómo hacerlo en este tutorial de SSH.
2. Descarga Composer desde el sitio web oficial con el siguiente comando:

   php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

3. Verifica la firma del instalador (SHA-384) para asegurarte de que el archivo del instalador no está dañado. Introduce:

   php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1e613307e16318854d24ae64f26d17af3ef0bf7cfb710ca74755a') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

   La larga cadena de caracteres en el comando anterior (“e0012edf…“) es la firma del instalador. Cambia cada vez que sale una nueva versión de Composer. Por lo tanto, asegúrate de obtener el último SHA-384 de esta página.

4. Una vez hecho esto, puedes instalar Composer local o globalmente. La instalación local significa que el administrador de dependencias se almacenará en tu directorio actual, y debes especificar la ruta antes de ejecutar los comandos correspondientes. Mientras tanto, la instalación global te permite ejecutar Composer desde cualquier lugar de tu sistema almacenándolo en el directorio /usr/local/bin. Aquí te explicamos cómo completar ambos métodos:
   • Instalación local:

     php composer-setup.php

     Instalación global:

     php composer-setup.php --install-dir=/usr/local/bin --filename=composer

     Obtendrás este resultado:

     All settings correct for using Composer
     Downloading...
     
     Composer (version 1.10.5) successfully installed to: /usr/local/bin/composer

5. Una vez hecho esto, elimina el instalador:

   php -r "unlink('composer-setup.php');"

6. Prueba la instalación de Composer:

   composer

   La línea de comando debería mostrarte este resultado:

      ______
     / ____/___ ____ ___ ____ ____ ________ _____
    / / / __ / __ `__ / __ / __ / ___/ _ / ___/
   / /___/ /_/ / / / / / / /_/ / /_/ (__ ) __/ /
   ____/____/_/ /_/ /_/ .___/____/____/___/_/
                     /_/
   
   Composer version 1.10.5 2020-02-12 16:20:11

2. Instalando Composer en Windows

Comenzar a usar Composer en una máquina con Windows es un poco diferente. No se necesitan instrucciones de línea de comandos para descargar e instalar el software.

Simplemente sigue estos pasos:

1. Instala PHP en tu computadora. Recomendamos usar XAMPP con este propósito, ya que el proceso es sencillo y puedes completarlo en unos minutos.
2. Una vez que XAMPP esté instalado, descarga la última versión de Composer.
3. Ejecuta el asistente de instalación de Composer. Cuando te solicite que actives el modo desarrollador, ignóralo y continúa con el proceso de instalación.
   
4. Aparecerá otra ventana y te pedirá que ubiques la línea de comando PHP. Por defecto, está en C:/xampp/php/php.exe. Después de especificar la ubicación, haz clic en Siguiente.
5. Se te solicitará la configuración de proxy. Deja la casilla sin marcar y omite esta parte presionando Siguiente. Luego, en la última ventana, haz clic en Instalar.
6. Después de completar la instalación, abre el símbolo del sistema. Presiona CTRL + R, escribe “cmd” y haz clic en OK.
   
7. Ingresa el siguiente comando:

   composer

¡Gran trabajo! Ahora tienes Composer instalado en tu computadora con Windows. El instalador agregará automáticamente Composer a la variable PATH. Ahora puedes abrir el símbolo del sistema y ejecutar el software desde cualquier lugar.

Generando y comprendiendo composer.json

Ahora viene la parte interesante: usar Composer en tu proyecto PHP.

Para lograr esto, debes generar un archivo composer.json. Puedes considerarlo como una forma de buscar datos de una lista para Composer. Este archivo contiene paquetes (dependencias) que deben descargarse.

Además, composer.json también verifica la compatibilidad de la versión con tu proyecto. Esto significa que si estás utilizando un paquete anterior, composer.json te lo informará para evitar problemas futuros.

Tienes la opción de crear y actualizar composer.json tú mismo. Sin embargo, teniendo en cuenta que este es un tutorial sobre la automatización de tareas redundantes, no te recomendamos que crees el archivo manualmente.

Demostremos la utilidad de composer.json creando un proyecto de ejemplo.

Nuestro proyecto es un simple temporizador PHP, que permite a los desarrolladores descubrir cuánto tiempo lleva ejecutar el código. Esto es muy útil para fines de depuración y optimización.

Puedes seguir estos pasos:

1. Crea un nuevo directorio para el proyecto. Como nuestro proyecto es un temporizador, simplemente nombraremos la carpeta phptimer. Para hacer esto, ejecuta el siguiente comando:

   mkdir phptimer

2. Ingresa el nuevo directorio creado:

   cd phptimer

3. Encuentra un paquete o biblioteca para el proyecto. El mejor lugar para lograrlo es Packagist, donde encontrarás toneladas de bibliotecas para ayudar al desarrollo de tu proyecto. Para este tutorial, necesitamos un paquete de temporizador. Para obtenerlo, simplemente escribe timer en la barra de búsqueda:
   
   Como puedes ver, hay varios paquetes de temporizadores disponibles y cada uno tiene un nombre y una pequeña descripción de lo que hace. En este ejemplo, elegimos phpunit/php-timer ya que tiene la mayoría de las descargas y la mayoría de las estrellas de GitHub.
4. Especifica el paquete deseado para que Composer pueda agregarlo a tu proyecto:

   composer require phpunit/php-timer

   La salida mostrará la versión de phpunit/php-timer:

   Using version ^1.0 phpunit/php-timer

El símbolo de intercalación (^) se define como la opción para una interoperabilidad máxima. Esto significa que Composer siempre actualizará el paquete hasta que una determinada versión haga que falle de alguna manera.

En nuestro caso, el rango de actualización del paquete es >=1.0.9 <2.0.0, ya que la versión 2.0.0 romperá la compatibilidad con versiones anteriores. Para obtener información detallada sobre las versiones en Composer, visite la página de documentación.

Después de ejecutar el comando anterior, el directorio de su proyecto tendrá dos archivos nuevos: composer.json y composer.lock, y una carpeta llamada vendor. Este es el directorio donde Composer almacenará todos tus paquetes y dependencias.

Usando el Script Autoload

Tu proyecto es casi bueno, y lo único que queda por hacer es cargar la dependencia en tu script PHP. Y, afortunadamente, el archivo de carga automática de Composer te ayuda a completar este proceso más rápido.

Para usar la carga automática, escribe la siguiente línea antes de declarar o instanciar nuevas variables en tu secuencia de comandos:

https://getcomposer.org/doc/articles/versions.md

Te daremos un ejemplo para ayudarte a comprender mejor.

Digamos que quieres probar nuestro proyecto phptimer:

1. Abre el editor de nano texto para crear un script llamado demo.php.

   nano demo.php

   Luego, pega las siguientes líneas en tu archivo:

   <?php
   require __DIR__ . '/vendor/autoload.php'
   Timer::start();
   // your code
   $time = Timer::stop();
   var_dump($time);
   print Timer::secondsToTimeString($time);

2. Ejecuta el script:

   php demo.php

   El terminal debe mostrar una salida similar a la siguiente:

   double(1.0893424438611E-5)
   0 ms

Actualización de las dependencias de tu proyecto

Por último, debes saber cómo actualizar tus paquetes. Esto lo puedes hacer de dos maneras:

• Actualización universal. Para verificar e instalar actualizaciones para todos tus paquetes y dependencias a la vez, escribe el siguiente comando:

  composer update

• Actualización específica del paquete. Ejecuta este comando para verificar las actualizaciones de uno o más paquetes específicos:

  composer update vendor/package vendor2/package2

Recuerda reemplazar la parte de vendor/package con el nombre del paquete que deseas actualizar.

Al ejecutar el comando de update, Composer también actualiza los archivos composer.json y composer.lock para que coincidan con el estado actual de las dependencias de tu proyecto.

Conclusión

Composer ayuda a los desarrolladores en la gestión de dependencias de proyectos PHP. Gracias a este software, pueden integrar y administrar fácilmente paquetes de código abierto en un solo lugar.

Además, Composer también puede resolver dependencias por proyecto. Por lo tanto, los desarrolladores pueden controlar los paquetes para cada proyecto y mantener el tamaño del proyecto bajo control.

En este artículo, has aprendido cómo instalar y usar Composer de manera efectiva. Para resumir, revisemos todos los pasos una vez más:

1. Instala Composer en un sistema de alojamiento compartido, Linux, macOS o Windows.
2. Genera y comprende el archivo composer.json.
3. Utiliza la secuencia de comandos de carga automática (Autoload Script) para cargar dependencias en tu archivo PHP.
4. Actualiza las dependencias de tu proyecto.

Esperamos que al seguir nuestra guía, tengas una base sólida para crear proyectos increíbles con PHP. Buena suerte y no dudes en hacer cualquier pregunta en la sección de comentarios a continuación.