Introducción
Para desarrollar Laravel en Windows, la mejor práctica es usar WSL (Windows Subsystem for Linux). Como puedes usar tal cual la toolchain de Linux, los mismos comandos funcionan igual que en macOS o en el servidor de producción. En esta guía se explica cómo instalar PHP, Composer y Node.js (mediante nvm) sobre Ubuntu en WSL 2 hasta llegar al punto en quelaravel new funcione.
Entorno objetivo: Windows 10 (versión 2004 o superior) o Windows 11. Se usa WSL 2.
Instalación de WSL
1
Abre PowerShell como administrador
Busca “PowerShell” en el menú de inicio y elige “Ejecutar como administrador”.
2
Instala WSL y Ubuntu
3
Configura Ubuntu
Tras reiniciar, Ubuntu se inicia automáticamente. Configura nombre de usuario y contraseña. Esta contraseña se usa con el comando
sudo.4
Actualiza la lista de paquetes
En la terminal de Ubuntu, ejecuta lo siguiente.
Instalación de PHP
Los repositorios estándar de Ubuntu pueden incluir versiones antiguas de PHP. Instala la versión más reciente usando el PPAondrej/php.
1
Instala los paquetes necesarios
2
Añade el PPA ondrej/php
3
Instala PHP 8.3 y las extensiones necesarias
Laravel 13 requiere PHP 8.3 o superior.
4
Verifica la versión
PHP 8.3.x o superior, la instalación es correcta.5
(Opcional) Cambiar entre varias versiones
Si necesitas varias versiones de PHP, puedes alternarlas con Aparecerá la lista de versiones instaladas; introduce el número de la versión que quieras usar.
update-alternatives.Instalación de Composer
Se instala Composer usando el instalador oficial.1
Comprueba los paquetes necesarios
2
Descarga y ejecuta el instalador oficial
3
Verifica la versión
4
Configura la ruta de la instalación global
Añade Aplica la configuración.
~/.composer/vendor/bin al PATH para poder usar paquetes instalados con composer global require (como el instalador de Laravel).Añade la siguiente línea a ~/.bashrc (o ~/.zshrc).Instalación de nvm
Node.js se instala por usuario mediante nvm (Node Version Manager). Como se puede gestionar sinsudo, encaja bien con herramientas de IA o CLIs que usan paquetes npm globales.
1
Instala nvm
El script de instalación más reciente se puede consultar en el repositorio de GitHub de nvm.
2
Añade líneas al archivo de configuración del shell
El script de instalación añade automáticamente lo siguiente a Aplica la configuración.Si usas zsh, añade lo mismo en
~/.bashrc. Si no se añade, hazlo manualmente.~/.zshrc y aplícalo con source ~/.zshrc.3
Verifica la instalación
Instalación de Node.js
1
Instala la versión LTS
2
Establece como predeterminada
Para que se use automáticamente también en sesiones de terminal nuevas, establece la versión por defecto.
3
Verifica las versiones
Verificar la instalación de Laravel
1
Instala el instalador de Laravel
2
Crea un nuevo proyecto
3
Arranca el servidor de desarrollo
http://localhost:8000; si aparece la página de bienvenida de Laravel, ya está listo.Extra: herramientas para mejorar la eficiencia del desarrollo
Windows Terminal
Con Windows Terminal puedes gestionar de forma unificada WSL, PowerShell y Command Prompt en varias pestañas. Se instala gratis desde Microsoft Store.- Operar varios shells en paralelo mediante pestañas
- Se puede establecer el shell de Ubuntu como predeterminado
- Fuente y colores libremente personalizables