Cómo instalar PHP Composer en Rocky Linux 8

PHP Composer es el gestor de dependencias más utilizado para PHP. Te permite declarar las dependencias que necesita tu proyecto, y las gestionará (instalará/actualizará) por ti.

Descargar, instalar y actualizar dependencias puede ser un dolor y podría distraerte de escribir código. Un gestor de dependencias hará tu vida como desarrollador más fácil al encargarse de eso por ti.

Antes de Composer, había algunas opciones diferentes para gestionar las dependencias del proyecto, como PEAR y PHP Package Manager. Hoy en día, Composer se ha convertido en el estándar de facto para la gestión de dependencias en PHP.

Si todavía estás usando PEAR o PHP Package Manager, entonces podría ser hora de un cambio. Hay varias razones para usar Composer:

• Está escrito en PHP y no requiere instalación de software adicional (como Python)
• Soporta paquetes globales y locales/privados
• Miles de bibliotecas y aplicaciones ya dependen de él, así que al usar Composer, podrás encontrar fácilmente paquetes y actualizaciones.

Requisitos previos

Para poder instalar PHP Composer en Rocky Linux 8.4, necesitarás:

• Tener PHP versión 5.3 o posterior instalado en tu sistema (y debe poder ejecutar la extensión Phar).
• Se requiere acceso root para la instalación.

Actualizando el sistema

Antes de hacer cualquier otra cosa, asegúrate de que los paquetes de tu sistema estén actualizados. Ejecuta los siguientes comandos para actualizar los paquetes del sistema.

sudo dnf check-update

sudo dnf update -y

Instalando PHP en Rocky Linux 8.4

Antes de poder instalar Composer, necesitas tener PHP y el intérprete de PHP instalados en tu sistema.

Por defecto, el repositorio AppStream viene con PHP 7.2, 7.3 y 7.4. Puedes listar todas las versiones de PHP disponibles ejecutando el siguiente comando.

sudo dnf module list php

Verás una salida como la siguiente.

En esta guía, instalaremos PHP 7.4. Debes elegir una versión de PHP que se adapte a tus necesidades, aunque asegúrate de basar tu decisión no solo en esta guía, sino también en informes de compatibilidad como este.

Ejecuta los siguientes comandos para habilitar e instalar PHP 7.4.

sudo dnf module enable php:7.4

sudo dnf install php php-cli php-gd php-curl php-zip -y

sudo dnf install php-mbstring php-opcache php-intl php-mysqlnd -y

Ahora puedes verificar si PHP se instaló correctamente ejecutando este comando.

php -v

Deberías obtener la siguiente salida.

Instalando PHP Composer en Rocky Linux 8.4

Ahora que tienes una versión de PHP instalada en tu sistema, puedes usarla para descargar e instalar el binario de Composer.

Primero, ejecuta los siguientes comandos para descargar la última versión de Composer.

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

A continuación, verificaremos que el archivo descargado no esté dañado. Siempre debemos verificar el archivo descargado para asegurarnos de que no esté dañado. Composer puede ser muy sensible, y los errores pueden causar problemas con cómo usas Composer. Ejecuta el siguiente código para verificar que el archivo del instalador no esté dañado.

HASH=`curl -sS https://composer.github.io/installer.sig`

echo $HASH

php -r "if (hash_file('SHA384', '/tmp/composer-setup.php') === '$HASH') { echo 'Instalador verificado'; } else { echo 'Instalador corrupto'; unlink('composer-setup.php'); } echo PHP_EOL;"

Deberías ver el texto “Instalador verificado” cuando la verificación sea exitosa como se muestra a continuación. Si no obtienes la salida esperada, es probable que el archivo esté dañado y deberías intentar descargarlo nuevamente. Luego, repite el proceso de verificación hasta que obtengas la salida esperada “Instalador verificado”.

Ahora tienes dos opciones para instalar Composer en tu sistema.

La Opción 1 es instalar Composer globalmente en tu sistema, lo que significa que será accesible desde cualquier directorio de tu sistema y se podrá usar en cualquier lugar. Usa esta opción si deseas usar Composer como una herramienta de línea de comandos, y no solo como un gestor de dependencias para tus proyectos PHP.

Si eliges esta opción, ejecuta los siguientes comandos.

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

El comando anterior instalará Composer globalmente con el nombre de comando composer en /usr/local/bin.

Ahora puedes verificar si instalaste Composer correctamente ejecutando este comando.

composer

Deberías obtener la siguiente salida.

La Opción 2 es instalar Composer localmente en el directorio actual para que solo se use por este proyecto específico.

Para instalar Composer localmente, ejecuta los siguientes comandos.

sudo php composer-setup.php

El comando anterior instalará Composer localmente en el directorio actual para que solo se use por este proyecto específico. Puedes usar Composer ejecutando ./composer.phar .

Probando PHP Composer

Ahora que has instalado Composer, puedes usarlo para crear un nuevo proyecto que puedes probar con tu instalación de Composer.

Es una regla general que siempre debes crear un directorio separado para cada proyecto en el que trabajes. Ejecuta los siguientes comandos para crear un nuevo directorio para tu proyecto de prueba y navegar al directorio recién creado.

cd && mkdir php-composer-test && cd php-composer-test

Ahora puedes ejecutar el siguiente comando para inicializar un nuevo proyecto con Composer.

composer init

El comando anterior inicializará un nuevo proyecto con todos los detalles que has seleccionado.

El comando composer init también crea un nuevo archivo composer.json en el directorio actual como se muestra a continuación. Es un archivo en formato JSON que contiene todos los requisitos del proyecto. Composer utiliza este archivo para instalar las dependencias requeridas para tu proyecto.

Ahora es el momento de cargar un paquete a tu proyecto. Dirígete a https://packagist.org y busca un paquete para instalar en tu proyecto.

Por ejemplo, si deseas instalar el paquete Remove Stop Words, que puede ayudarnos a eliminar palabras vacías de una cadena. Si buscas el término “Remove Stop Words” en Packagist, deberías ver el siguiente resultado.

Para agregar un nuevo paquete, ejecuta el comando composer require y selecciona el paquete (sin ninguna versión) que deseas cargar a tu proyecto actual.

composer require rap2hpoutre/remove-stop-words

Composer decidirá automáticamente qué versión del paquete usar. Composer descargará el paquete de Packagist a tu directorio actual y extraerá el contenido de este paquete.

También actualizará el archivo composer.json con detalles sobre este nuevo paquete. También creará un nuevo archivo - composer.lock, y un nuevo directorio vendor como se muestra a continuación.

El archivo composer.lock es utilizado por Composer para bloquear la versión del paquete que está instalada en tu proyecto actual. Este archivo se utiliza para evitar conflictos con otras instalaciones del mismo paquete, o cuando clonas tu proyecto. El directorio vendor contiene todas las dependencias de tu proyecto.

Para actualizar las dependencias del proyecto, ejecuta el comando composer update. Composer mirará primero el archivo composer.lock para averiguar qué versión del paquete ya está instalada, y luego actualizará este paquete con la última versión disponible en Packagist.

composer update

Salida de ejemplo:

Para actualizar paquetes específicos, ejecuta el siguiente comando.

composer update vendor/package

Para eliminar un paquete específico, ejecuta el siguiente comando.

composer remove vendor/package

Por ejemplo, si ya no necesitas el paquete Remove Stop Words, puedes ejecutar el siguiente comando para desinstalarlo de tu proyecto.

composer remove rap2hpoutre/remove-stop-words

Salida de ejemplo:

Nota: Se recomienda encarecidamente que no elimines el directorio vendor o su contenido porque este directorio contiene todas las dependencias que deben instalarse con Composer para ejecutar tu aplicación.

Conclusión

En este artículo, has aprendido cómo instalar el gestor de dependencias PHP Composer en Rocky Linux 8.4 para inicializar un nuevo proyecto, cargar nuevos paquetes, actualizar paquetes existentes o desinstalarlos de tu proyecto. También has aprendido algunos comandos básicos de Composer que se utilizan para gestionar las dependencias de tu proyecto.

Deja un comentario a continuación si tienes alguna pregunta o comentario.