💻 **Instalación de Laravel:** Usando Sail y preparando el entorno PHP

💻 Instalación de Laravel: Usando Sail y Preparando el Entorno PHP

El Primer Paso: El Motor de Nuestra Tienda Online

Antes de escribir cualquier código de negocio, debemos asegurarnos de tener la base correcta. Instalar **Laravel** y configurar el entorno de servidor local son los primeros pasos cruciales. Para nuestro proyecto de la Tienda Online, utilizaremos **Laravel Sail**, la solución oficial de Laravel basada en **Docker**, que nos proporciona un entorno profesional y consistente.

1. 🛠️ Herramienta Clave: Docker Desktop

Laravel Sail depende de **Docker Desktop**, la plataforma que permite ejecutar los componentes de Laravel (PHP, MySQL) en **contenedores aislados**, eliminando la necesidad de XAMPP.

Verificación de Docker: Instalación y Ejecución

Para que Sail funcione correctamente, Docker debe estar **instalado** y **activo**.

Verificar Instalación: Abre tu terminal y ejecuta docker --version. Si ves un número de versión, Docker está instalado.
Verificar Ejecución: Busca el ícono de la ballena 🐳 en la bandeja del sistema (cerca del reloj). Si el ícono es sólido, Docker está activo y listo.

1. ✅ Estado de Composer y PowerShell Script

Script de PowerShell: Ya has resuelto el problema de seguridad del script de PowerShell en VS Code seleccionando [E] Ejecutar siempre. Esto es común cuando se usa PowerShell por primera vez con VS Code.
Composer: Está correctamente instalado y funcionando (Composer version 2.7.6).
Ubicación: Estás en la ubicación correcta (PS C:\>) para crear el proyecto.

2. ❌ Problema con Docker Desktop

Si ves el siguiente mensaje en la terminal:

docker : El término 'docker' no se reconoce como nombre de un cmdlet...

Esto significa que **Docker Desktop no está instalado o no está configurado correctamente en el PATH** de tu sistema.

¡No puedes continuar con la instalación de Laravel Sail sin Docker!

🛠️ Próximo Paso: Instalar Docker Desktop

Para ejecutar Laravel Sail y continuar con el proyecto de la Tienda Online, sigue estos pasos:

Descargar Docker Desktop:
- Visita el sitio web oficial de Docker.
- Descarga la versión compatible con tu sistema operativo (Windows o macOS).
Instalar y Configurar:
- Ejecuta el instalador y sigue las instrucciones.
- Es posible que necesites habilitar características de virtualización como WSL 2 o Hyper-V en Windows durante la instalación. El instalador de Docker te guiará.
Iniciar Docker Desktop:
- Una vez instalado, abre Docker Desktop (busca el ícono de la ballena 🐳 en tus programas). La aplicación debe estar en ejecución (el ícono de la ballena debe estar sólido, no animado).
Verificación Final:
- Cierra y vuelve a abrir tu terminal (PowerShell).
- Ejecuta nuevamente el comando docker --version. Si ves un número de versión, significa que Docker está listo para usar.

Verificar Composer (Opcional)

Aunque Laravel Sail gestiona Composer, es útil verificar que esté funcionando correctamente en tu sistema:

Comando de verificación

composer -V

2. 🧭 Paso Crucial: Ubicación del Proyecto (cd ..)

Es importante asegurarse de que el nuevo proyecto se cree **fuera de cualquier instalación previa** (como XAMPP). Usa el comando cd .. para subir un nivel en la estructura de carpetas hasta la ubicación deseada.

Navegar a la Raíz de tu Disco (C:\>)

Si estás en una carpeta profunda (ej. C:\xampp\htdocs\...), usa cd .. repetidamente hasta llegar a la raíz.

Ejemplo de navegación

PS C:\xampp\htdocs\tu_carpeta> cd ..
PS C:\xampp\htdocs> cd ..
PS C:\xampp> cd ..
PS C:\>

¡Importante! El proyecto **tienda-online** se creará en la ubicación en la que te encuentres al ejecutar el siguiente comando.

3. 🚀 Instalación y Arranque del Servidor

¡Todo listo! Ahora es momento de instalar y arrancar la Tienda Online.

Paso 1: Crear el Proyecto (Solo una vez)

Asegúrate de estar en la ubicación correcta (por ejemplo: PS C:\> o PS C:\xampp\htdocs>) antes de ejecutar el comando.

Comando de Instalación de Laravel Sail

curl -s "https://laravel.build/tienda-online" | bash

⚠️ Problemas Comunes y Soluciones

🧩 Problema 1: PowerShell pide "`Uri:`" o muestra error `DriveNotFoundException`

Esto ocurre porque PowerShell no usa el curl real, sino un alias llamado Invoke-WebRequest.

💡 Solución:

Ejecuta el comando desde una terminal Linux (WSL) o Git Bash:

curl -s "https://laravel.build/tienda-online" | bash

Si prefieres PowerShell, usa el comando completo del ejecutable:

curl.exe -s "https://laravel.build/tienda-online" | bash

🐋 Problema 2: Error "`docker: no se reconoce como nombre de un cmdlet...`"

Significa que Docker Desktop no está instalado, o no está corriendo correctamente.

💡 Solución:

Instala Docker Desktop desde el sitio oficial.
Verifica que el icono de la ballena 🐳 esté visible y sólido (indicando que Docker está activo).
Abre una nueva ventana de PowerShell y ejecuta:

docker --version

Si devuelve un número de versión (por ejemplo, Docker version 28.5.1), Docker está listo.

🔒 Problema 3: Error "`bash: command not found`"

Esto ocurre si intentas ejecutar el comando en PowerShell sin tener un entorno Linux o Git Bash disponible.

💡 Solución:

Instala y abre Git Bash o WSL (Ubuntu).
Vuelve a ejecutar el comando dentro de ese entorno.

curl -s "https://laravel.build/tienda-online" | bash

🧰 Problema 4: Permisos o errores al crear carpetas

En algunos casos, el sistema puede impedir la creación de archivos o carpetas.

💡 Solución:

Ejecuta la terminal como Administrador (clic derecho → “Ejecutar como administrador”).
Asegúrate de estar en una ruta donde tengas permisos de escritura, como C:\ o C:\Users\TuUsuario\.

🐧 Problema 5: `Subsistema de Windows para Linux no tiene distribuciones instaladas`

Este mensaje aparece cuando WSL (Subsistema de Windows para Linux) está habilitado, pero aún no tienes instalada ninguna distribución Linux (por ejemplo, Ubuntu).

💡 Causa:

Laravel Sail requiere un entorno Linux para ejecutarse dentro de Docker. Docker Desktop usa WSL2 en Windows, por lo que necesitas tener una distribución instalada y configurada.

🧭 Solución paso a paso:

Abre PowerShell como Administrador y ejecuta el siguiente comando para ver las distribuciones disponibles:
```
wsl --list --online
```
Instala Ubuntu (recomendado) con el siguiente comando:
```
wsl --install -d Ubuntu
```
Espera a que se complete la instalación y reinicia tu PC si el sistema lo solicita.
Una vez instalado, abre Ubuntu desde el menú de inicio o ejecuta:
```
wsl
```
Crea tu usuario y contraseña de Linux cuando se te pida (esto ocurre solo la primera vez).
Luego, dentro de la terminal de Ubuntu, navega hasta tu disco C:
```
cd /mnt/c
```
y entra a la carpeta donde quieras instalar el proyecto (por ejemplo):
```
cd /mnt/c/xampp/htdocs
```

Finalmente, ejecuta el comando de instalación:

curl -s "https://laravel.build/tienda-online" | bash

💡 Nota de seguridad:

Instalar Ubuntu mediante WSL no reemplaza Windows ni modifica tus archivos ni particiones. Ubuntu se ejecuta como una “aplicación” dentro de Windows, usando una máquina virtual ligera. Puedes acceder a tus archivos de Windows desde Ubuntu y desinstalarlo fácilmente si lo deseas:

wsl --unregister Ubuntu

Todo tu sistema Windows seguirá funcionando normalmente.

✅ Verificación final:

Una vez instalado, entra en la carpeta y levanta el entorno con:

cd tienda-online
./vendor/bin/sail up -d

Luego abre tu navegador y visita http://localhost. Si ves la pantalla de Laravel, tu entorno ya está funcionando correctamente 🎉

🎉 Si todo va bien...

El instalador descargará y configurará tu nuevo proyecto tienda-online. Una vez finalice, verás un mensaje confirmando la instalación de Laravel.

Para continuar:

cd tienda-online
./vendor/bin/sail up -d

Paso 2: Iniciar el Servidor de Desarrollo (Cada vez que trabajes)

Entra en la nueva carpeta tienda-online y usa sail up -d para arrancar los servicios (PHP, MySQL) en segundo plano:

Comandos para iniciar el servidor

cd tienda-online
./vendor/bin/sail up -d

Una vez finalizado, abre tu navegador en http://localhost para verificar la instalación.

4. ✅ ¡Instalación Exitosa!

Si ves la pantalla de bienvenida de Laravel en tu navegador, la instalación fue un éxito. Ahora la carpeta tienda-online contiene el corazón de nuestro proyecto.

TIP: Para ejecutar cualquier comando de Artisan (por ejemplo, crear modelos), utiliza siempre el prefijo ./vendor/bin/sail artisan para hacerlo dentro del contenedor de PHP.

🏠 Volver al Índice Siguiente: Modelos y Migraciones (Creación de Tablas) 🧱

💻 **Instalación de Laravel:** Usando Sail y preparando el entorno PHP