Laravel Sail y entorno local con Docker

Qué es Laravel Sail

Laravel Sail es la interfaz oficial basada en Docker para desarrollar Laravel sin instalar PHP, Composer ni la base de datos directamente en tu máquina. Define servicios en docker-compose.yml y comandos ./vendor/bin/sail sustituyen a php y composer dentro del contenedor.

Sail es especialmente útil en equipos donde todos deben tener el mismo entorno y en formación corporativa donde se evita depender de instalaciones locales heterogéneas.

En la práctica, tú ejecutas Sail en tu equipo, pero PHP, Composer y tanto los servicios como la base de datos corren dentro de contenedores definidos por Docker Compose.

flowchart LR
  subgraph equipo [Equipo del desarrollador]
    T[Terminal]
    S[Sail]
  end
  subgraph contenedores [Contenedores Docker]
    P[PHP y aplicación Laravel]
    D[Servicio de base de datos]
    R[Redis u otros servicios]
  end
  T --> S
  S --> P
  P --> D
  P --> R

Instalación en un proyecto nuevo

Al crear el proyecto puedes incluir Sail:

curl -s "https://laravel.build/mi-app" | bash
cd mi-app
./vendor/bin/sail up -d

En un proyecto existente:

composer require laravel/sail --dev
php artisan sail:install

El asistente pregunta qué servicios activar (MySQL, Redis, Mailpit, etc.). Tras instalar, arranca los contenedores:

./vendor/bin/sail up -d

La aplicación queda disponible en el puerto configurado (por defecto 80 u 8080 según versión).

Comandos habituales

Ejecutar Artisan, Composer o NPM dentro del contenedor:

./vendor/bin/sail artisan migrate
./vendor/bin/sail composer require paquete/ejemplo
./vendor/bin/sail npm run dev

Puedes crear un alias alias sail='./vendor/bin/sail' en tu shell para acortar los comandos.

Buenas prácticas

• Versionar el docker-compose.yml generado por Sail para que todo el equipo use la misma imagen.
• No subir volúmenes con datos sensibles al repositorio; usar .env y secretos fuera del control de versiones.
• En CI/CD, los tests pueden ejecutarse con imágenes Docker equivalentes al stack de Sail.