Pasos para instalar composer. El uso de las librerías y dependencias en un proyecto de PHP es muy importante para el correcto funcionamiento. En tal sentido, debemos de conocer cómo podemos instalar y actualizar las librerías de manera correcta.
La solución es usar composer y ahora las dependencias de los proyectos de PHP son gestionadas por programa de manera profesional.
¿Cómo instalar Composer para las dependencias en PHP?
Para instalar composer en Windows debemos de seguir estos 3 pasos:
- Instalar PHP en tu PC. Usaremos el paquete XAMPP para este ejemplo, porque es fácil de instalar.
- Descargar e instalar el software Composer, la última versión de Composer.
- Instalar el software de Composer. Cuando te pida que actives el modo desarrollador, ignóralo y continúa con el proceso de instalación.
Genial, una vez completado los 3 pasos ya tenemos instalado composer en nuestra computadora y ya podemos usarlo para descargar dependencias PHP.
En este articulo hablaremos sobre las ventajas, usabilidad, instalación y cómo funciona composer.
¿Por qué debemos usar composer?
Es muy recomendado porque gestiona las dependencias y las actualizaciones de librerías PHP. Muchos proyectos de PHP, en algún momento, llega a necesitar dependencias. Por ejemplo: DOMPDF, PhpSpreadsheet, PHPMailer, entre otras dependencias .
Es ahí cuando las dependencias cumplen un rol fundamental. En el caso de usar estas dependencias, podemos experimentar algunas ventajas:
- Instalar la dependencia directamente de la fuente del desarrollador sin virus ni modificaciones por terceros.
- Actualizaciones con ejecutar una sola línea de código
- Solo basta con declarar un includes o requires para tener todos los paquetes
Este programa composer viene a solucionar y ayudar al programador, aparte de que proporciona un entorno amigable en donde todos pueden publicar librerías.
¿Cómo usar composer con PHP?
Una vez que la instalación de composer fue exitosa, podemos comenzar a inicializar el programa un proyecto con:
composer initEste comando creará un composer.json que es en donde está la lista de dependencias y otras cosas, así como una carpeta llamada vendor que será en donde pondrá tus dependencias.
Otra opción es ejecutar la consola de Windows llamado CMD
Este comando al ejecutar nos mostrara la pantalla negra de Windows llamado consola.
A continuación, haciendo uso de los comandos de la consola tenemos que ir a donde tenemos instalado el paquete XAMP, específicamente a la carpeta HTDOCS. Además, una vez dentro de esa carpeta podemos ejecutar los comandos de las diferentes librerías para poder descargar o actualizar la dependencia.
Vamos a ver un ejemplo de uso: Por ejemplo, vamos a instalar la librería DOMPDF que se usa para crear documentos PDF a través de PHP.
Pasos para instalar composer y su funcionamiento
Para que composer funcione correctamente debemos de realizar lo siguiente:
- Activar el paquete XAMP
- EL servicio de Apache y PHP deben estar activo correctamente
- Tener una carpeta que contenga nuestro proyecto y ahí instalar la dependencia
- Declara mediante un require la dependencia
Estando en la consola de Windows solo debemos de ejecutar esta línea de código para que descargue el paquete DOMPDF.
composer require dompdf/dompdfExplicación del código anterior
- Primero hay que ingresar el comando de composer
- Segundo colocar REQUIRE
- Tercero nombrar el autor de la dependencia y haciendo uso de la barra / llamar el nombre de la librería.
Veamos la sintaxis del comando a ejecutar:
composer require autor/libreríaNOTA:
Recuerda que las librerías poseen versiones que trabajan conjuntamente con la versión del PHP y si necesitas una versión específica se puede poner con los dos puntos. En este caso ^:4.0 significa superior a la versión 4.
Instalando DOMPDF.
Siguiendo con el ejemplo anterior vamos a instalar el paquete DOMPDF. Por lo tanto, vamos a ejecutar el comando y al término de la instalación nos mostrara la siguiente ventana.
Si observas, dentro de la carpeta HTDOCS hemos creado una carpeta llamada (proyecto) dentro de esa carpeta debemos de instalar el DOMPDF. Una vez ejecutado deberá mostrar todo correcto sin ningún error.
¿Como declarar la dependencia en PHP?
Si todos los pasos anteriores fueron ejecutados correctamente en nuestra carpeta del proyecto se nos mostrara una capeta, Recuerda que composer genera una carpeta de nombre vendor y dentro de ella un autoload.php. Además, de dos ficheros llamados composer.json y composer.lock.
La estructura generada dentro de nuestro proyecto será similar a:
Declarar autoload.php
Para declarar este fichero tenemos que ingresar a la carpeta de nuestro proyecto y se tiene que crear un archivo index.php u otro nombre y agregar la sentencia REQUIRE con el archivo autoload.php, veamos un ejemplo:
Resumiendo.
Es importante incluir el autoload.php en donde quieras usar las librerías o clases. Además, no se olviden de respetar la ruta de archivo donde se encuentra el autoload.php.
<?php
require_once "vendor/autoload.php";
?>Actualizar librerías instaladas
Las versiones de PHP se incrementan cada año y es importante actualizar las librerías y estamos obligado a hacerlo por temas de seguridad y compatibilidad, podemos hacerlo ejecutando la siguiente línea de código:
composer updateAspectos fundamentales de composer en PHP
A continuación, veremos algunos detalles y aspectos:
- Lee y ejecuta el archivo composer.json
- Si no lo encuentra, indica error
- Instala las dependencias en la carpeta vendor.
- Genera un archivo composer.lock que indica la última vez que instalaste o actualizaste librerías.
- Trabaja bajo el archivo autoload.php que se encarga de requerir los paquetes de las dependencias.
Conclusión
El uso de composer es muy recomendado en proyectos web desarrollados bajo PHP y framework del PHP. Por lo tanto, podemos descargar y ejecutar las principales dependencias con una simple línea de código.
- Además, podemos actualizar de versión de las dependencias con una línea de código.
- Es muy recomendado porque descarga las dependencias desde los repositorios oficiales de los desarrolladores
Espero que este articulo les ayude a entender un poco acerca del funcionamiento de composer.
