Instala Dependencias en Laravel Sail SIN Composer: ¡Fácil y Rápido!

Cuando trabajamos con Laravel Sail, una solución popular para entornos de desarrollo basados en contenedores Docker, podemos encontrarnos con la necesidad de instalar las dependencias de un proyecto clonado. Por ejemplo, si descargas un repositorio de Laravel que utiliza Sail, pero no tienes Composer instalado en tu equipo, puede parecer un problema.

Es importante destacar que esto solo aplica a proyectos clonados que no tienen las dependencias instaladas. Cuando creas un proyecto desde cero con Laravel Sail, no necesitas preocuparte por esto, ya que Sail se encarga automáticamente de instalar todas las dependencias incluso si no tienes Composer o PHP configurado en tu sistema.

En este artículo, veremos cómo instalar las dependencias de un proyecto Laravel Sail clonado, utilizando un contenedor Docker con Composer, sin necesidad de instalar Composer en tu equipo.

El problema: Proyectos clonados sin dependencias instaladas

Cuando clonas un proyecto Laravel Sail desde un repositorio, este no incluye las dependencias necesarias en la carpeta vendor. Por tanto, antes de poder usar comandos como sail up -d para iniciar los contenedores, necesitas instalar las dependencias con Composer.

Si no tienes Composer ni PHP configurado en tu equipo local, puedes usar Docker para solucionar este problema de manera rápida y sencilla.

La solución: Usa Docker para instalar dependencias

En lugar de instalar Composer en tu sistema, puedes utilizar un contenedor Docker con Composer para instalar las dependencias. Este es el comando necesario:

docker run --rm \
    -u "$(id -u):$(id -g)" \
    -v $(pwd):/var/www/html \
    -w /var/www/html \
    laravelsail/php84-composer:latest \
    composer install --ignore-platform-reqs

Desglosemos el comando:

1. docker run --rm: Crea un contenedor temporal que se elimina automáticamente después de ejecutarse.

2. -u "$(id -u):$(id -g)": Establece los permisos de usuario y grupo para los archivos generados.

3. -v $(pwd):/var/www/html: Monta el directorio actual como /var/www/html dentro del contenedor.

4. -w /var/www/html: Define el directorio de trabajo dentro del contenedor.

5. laravelsail/php84-composer:latest: Usa la imagen de Docker de Laravel Sail con Composer y la versión de PHP requerida (en este caso, PHP 8.4). Asegúrate de usar la versión de PHP que coincida con tu proyecto.

6. composer install --ignore-platform-reqs: Ejecuta composer install, ignorando los requisitos de la plataforma local.

Paso a paso para proyectos clonados

1. Clona el repositorio:
   Comienza por clonar el proyecto Laravel desde el repositorio correspondiente:

   git clone https://github.com/usuario/proyecto-laravel.git
   cd proyecto-laravel

2. Instala las dependencias con Docker:
   Ejecuta el comando mencionado anteriormente. Asegúrate de ajustar la versión de PHP en la imagen Docker (php84-composer) según la versión requerida por el proyecto. Por ejemplo, si el proyecto utiliza PHP 8.4:

   docker run --rm \
       -u "$(id -u):$(id -g)" \
       -v $(pwd):/var/www/html \
       -w /var/www/html \
       laravelsail/php84-composer:latest \
       composer install --ignore-platform-reqs

3. Levanta los contenedores con Sail:
   Una vez instaladas las dependencias, puedes iniciar los contenedores de Laravel Sail:

   ./vendor/bin/sail up -d

4. Accede al proyecto:
   Abre el navegador y accede a la URL configurada en tu archivo docker-compose.yml (generalmente, http://localhost).

¿Por qué esto no sucede al crear un proyecto con Sail?

Cuando creas un nuevo proyecto Laravel con Sail, no necesitas realizar estos pasos, incluso si no tienes Composer en tu máquina. Laravel Sail se encarga de todo el proceso automáticamente, incluyendo la instalación de dependencias, al ejecutar comandos como:

curl -s "https://laravel.build/nombre-del-proyecto" | bash
cd nombre-del-proyecto
./vendor/bin/sail up -d

En este caso, el propio script inicial descarga las dependencias necesarias utilizando Docker, asegurando que puedas empezar a trabajar sin configurar Composer ni PHP manualmente.

Beneficios de este enfoque

1. No necesitas Composer ni PHP en tu máquina: Este método es ideal para entornos nuevos o equipos donde prefieres no instalar herramientas adicionales.

2. Evitas problemas de compatibilidad: Dado que el contenedor Docker ya tiene la versión específica de PHP y Composer requerida por tu proyecto, eliminas conflictos de versiones.

Notas importantes

• Asegúrate de usar la versión correcta de PHP: La imagen Docker que utilices debe coincidir con la versión de PHP definida en tu proyecto.

• Docker debe estar instalado: Este método requiere que tengas Docker configurado en tu sistema. Puedes descargarlo desde docker.com.

Conclusión

Cuando trabajas con proyectos Laravel Sail clonados, usar Docker para instalar las dependencias es una solución eficiente y limpia. Este enfoque evita la necesidad de configurar Composer o PHP en tu equipo local, manteniendo tu entorno limpio y sin conflictos.

Recuerda, este método no es necesario al crear un proyecto nuevo con Laravel Sail, ya que Sail se encarga automáticamente de instalar las dependencias en ese caso.

¿Te ha sido útil este artículo? ¡Comparte este artículo con tus conocidos!